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CHAPTER 1 

RDOS DRIVER IMPLEMENTATION 

INTRODUCTION 

In all real time computer control systems, the CPU reacts to input data from a real 

The incoming data is normally the result of a process device interrupt or an input - 
output operation completion interrupt. In general these interrupts differ from one 

CLLL^JLll^±. KJLlLy ±X1 \^1\:^ WO-y ill WlllV^ll \,n^y CI.X\^ O^X VIV^^U* 

When a significant event occurs, a signal is transmitted to the computer as an 
interrupt requiring a special subroutine to take appropriate action. Interrupts are 
usually assigned in order of urgency or priority, so that if two interrupts occur at 
the same moment, the more important interrupt is serviced first by the computer. 

How well a computer is able to respond to interrupts generally determines the max- 
imum capability of the real time system. A significant element in the responsive 
ability of any real time system is the, inclusion of a powerful and flexible multi- 
priority interrupt control program. 

This document outlines the methods of adding customer-assignable multi- priority 
servicing routines. These device drivers can be included as part of the resident 
RDOS operating system or they can be implemented as part of the user application 
program and attached to the interrupt dispatch program. 

CHARACTERISTICS OF INTERRUPTS 

Interrupts can be generated by conditions internal to the computer hardware itself 
(power monitor option), or by events which originate in the plant or the environ- 
ment that is being controlled (an external hardware interrupt like an analog-to-digital 
converter completion). 

Non-process interrupts may be caused by an error condition being detected, an interval 
timer run-down, an input-output (I/O) complete interrupt, etc. The I/O interrupt 
is characterized by the completion of an I/O device operation such as a paper tape 
or disk storage transfer function, which may Involve the reading or writing of one 
character or word in the case of program control or multiple words in the case of 
data channel operation. The concept of this type of interrupt is based on the impor- 
tance of keeping I/O devices active, thus improving job throughput . 

Process interrupts reflect process conditions which have been detected and which 
require an immediate change in program execution, such as may be caused by the 
closing of an electrical switch or contact, a rise in temperature above a prescribed 
limit, etc. 
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INTERRUPT PRIORITY SCHEME 

There are several ways in which priorities are determined for or assigned to devices 
on the I/O bus. An elementary priority is established by the hardware for devices 
that are requesting interrupts simultaneously: among those devices waiting with an 
active interrupt, the one which is physically closest to the processor on the bus is 
at the highest priority. 

The most significant method is to specify which devices can interrupt a service routine 
cuirently in progress. This is done by using a 16 bit priority mask. Each device 
is wired to a particular bit of this mask word. 

By means of the mask word, the interrupt servicing program can inhibit specified 
levels of interrupts and thus establish any priority structure. The biggest advantage 
of this means of priority level control is a near optimum priority response. To 
guarantee minimum response time to an interrupt, the mask bit assigned to this device 
should not be set for long periods of time. Through the judicious use of masking, 
data channels can be kept functioning for the transmission of data into and out of core 
storage while process interrupts are prevented from occurring. The function of 
masking is used to delay recognition of an interrupt (the important fact is that the 
interrupt is not lost). 

The mask bit assignments for standard devices supplied by DGC are as follows: 

Bit Positions Assigned Devices 

15 TTO 

14 TTI, QTY (4060 quad multiplexor), SLA (4073/4074 

Synchronous Line Adapter) 
13 PTP, RTC, IBM 360/370 interface 

12 PLT, LPT, MCAT (4038 multiprocessor communications 

adapter transmitter), MCAR (4038 multiprocessor com- 
munications adapter receiver) 
11 PTR 

10 CDR, CAS, MTA 

9 DSK 

8 ADCV, SCR (4015 synchronous communications 

controller receiver), SCT (4015 synchronous 
communications controller transmitter) 
7 DKP, DIO (4066 digital interface) 

6 XI (4067 external interrupt generator), PIT (Programm- 

able Interval Timer 4068) , IPB (Interprocessor Buffer) 
5 unassigned 

4 
3 
2 
1 

DCM (4026 asynchronous data commiuiications 

multiplexor) 
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Although slower devices are assigned to higher numbered bits in the mask, there is 
no established priority, since the program can use any mask configuration. All 
devices which have their mask bits set cannot cause an interrupt and are therefore 
regarded by the program as being of lower priority. 

An example of multi-level priority interrupt servicing is shown below for an environ- 
ment including a Teletype, line printer, and fixed head disk. 

Program Mask 

Fixed Head Disk Interrupt 717 



Line Printer Interrupt 17 

Teletype Interrupt 3 

Main Line User 

INTERRUPT DISPATCH PROGRAM 




At the precise moment an unmasked interrupt has been detected at the hardware 
level, the Interrupt Dispatch program (INTD) receives control to service the 
interrupt. The INTD program is assembled as an integral portion of the RDOS 
system and resides in core at all times. 

The INTD program is designed to do the following: 



, Identify the interrupting device 
. Save the machine status and all 
addressable registers 
, Set up the new priority mask 



.Direct control to the proper servicing routine. 
. Restore the previous priority mask 
. Restore the machine status and registers 
. Return to the interrupted program 



The INTD program directs control to the correct servicing routine by using the 
correct entry in the system Interrupt Branch Table (ITBL). ITBL is a 66 ^q word 
table, with displacements 1-64 corresponding to device codes 1-64. Each dis- 
placement corresponding to a device in the system contains the address of that 
device's DCT. All other displacements contain -1. 
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User Program 



interrupt 



ITBL 




iterrupt 


8 -word 


Service 


State 


Routine 


Save 




Area 



Flow of Control During Interrupts 
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DEVICE CONTROL TABLE (DCT) STRUCTURE 

Each device defined in the RDOS system must have the address of its DCT included 
in the interrupt branch table (ITBL) as explained in later sections. For interrupt 
servicing routines defined in the user's area, only the first three entries are needed. 
Words 7-26 of the DCT differ for byte and block oriented devices. 



Word 0. DCTSV- 



Address of an eight word interrupt state save area not used 
bv RDOS but reserved for comoatibilitv with RTOS. 



Word 1, DCTMS: 



Mask Word. Clear a bit for every priority considered 
higher than the priority of this device. The devices cor- 
respjonding to the priority bits tliat are left cleared will 
be permitted to interrupt the current device. Mask words 
which disable interrupts for all devices of equal or lesser 
priority than the named device follow: 



TTO 


3 


TTI, QTY, SLA 


3 


Fi'P, RTC, IBM 


7 


PLT, LFl', MCAT, MCAR 


17 


PTR 


1737 


CDR, MTA, CAS 


1777 


DSK 


717 


ADCV, SCR, SCT 


200 


DKP, DIO 


617 


XI, PIT 


1000 



Word 2, DCTIS: 
Word 3, DCTCH: 



Address of the device interrupt service routine. 

Device characteristic word. A list of device characteristics 
is given in the table on the page following. 
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DEVICE CONTROL TABLE (OCT) STRUCTURE (Continued) 
MNEMONIC BIT MEANING 



DCCPO 


15 


DCCGN 


14 


DCIDI 


13 


DCCNF 


12 


DCTO 


11 


DCKEY 


10 


DC NAP 


9 


DCRAT 


8 


DCPCK 


7 


DC LAC 


6 


DCSPO 


5 


DCFWD 


4 


DCFFO 


3 


DCLTU 


2 


DCC80 


1 



DCSPC 



iir^ J A ■r^/-i'-r«/-iT-\. 
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Word 5, DCTEX: 



Word 6, DCTDT: 



Device requiring leader /trailer 

Device requiring tab simulation 

Device requiring operator intervention 

Device requiring form feed simulation 

Teletype output device 

Keyboard input device (uncontrollable) 

Device requiring nulls after form feeds 

Device requiring rubouts after tabs 

Device requiring even parity check on input, 

even parity computation on output 

Device requiring line feeds after carriage returns 

Spoolable device (LPT, PTP, PLT, TTO) 

Full word device (any size greater than a byte). 

Form feed sent on . OPEN 

Convert lower to upper case ASCII 

Read 80 columns on input if set, 72 if reset. Send 

80 characters on output, 72 if reset. 

Spooling enabled if set to 1, disabled if reset 



Address of variable I/O instruction routine. 

Address of the device command dispatch table; bit set 
implies disk device. One entry for every RDOS I/O function. 
The table order must correspond exactly to the order of the 
ftinction given below. Each entry is an address to the routine 
implementing the named RDOS function. If the device does 
not permit a command, a -1 should be entered in place of 
the address. 



MNEMONIC 



DISPLACEMENT MEANING 



OF 

CF 
RS 
RL 
RR 

WS 
WL 
WR 



1 
2 
3 

4 
5 
6 
7 



Open a file for reading/writing by one 

or more users 

Close a file 

Read Sequential 

Read Line 

Read Random 

Write Sequential 

Write Line 

Write Random 
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DEVICE CONTROL TABLE (OCT) STRUCTURE (Continued) 
MNEMONIC DISPLACEMENT MEANING 



OA 
RO 
EO 
TO 



10 
11 
12 
13 



Word 7, DCTST: 



Open a file for appending 
vypen tor reauing oniy 
Exclusive read/write open 
Transparent (exclusive) open (does not 

Words 7-26. byte-oriented devices 



Address of the device start routine. The device start routine 
specification is as follows: 



Input device: 
Output device: 



Activate the device and return 
Character is passed in AGO 



Word 10,DCTBC: 
Word 11, DCTBP: 



Size of device buffer in bytes. 

Byte pointer to device buffer. 
Word 12, DCTPC: Base level (program) byte count. 
Word 13, DCTPP: Base level (program) byte pointer. 
Word 14, DCTQL: Link to device request bead chain. 
Word 15, DCTDP: Device data byte pointer. 
Word 16^ DCTDC: Device data count. 
Word 17, DCTQS: Bead status word (described in GENERALIZED I/O ROUTINES). 



Word 20, DCTBD: 
Word 21, DCTQP: 
Word 22, DCTTl: 
Word 23, DCTT2: 
Word 24, DCTTO: 
(Word 24, DCTCC: 
Word 25, DCTLC: 
(Word 25, DCTPR: 
Word 26, DCTON: 
(Word 26, DCTLK: 
Word 27, DCTOF: 
Word 30, DGTSL: 



Bead address (i. e. , the starting address of the first bead, word 14) 

Device queue starting address (initially -1). 

First temporary for device control. 

Second temporary for device control. 

Time out constant for input devices. 

Output device column counter. ) 

Output device Une counter. 

Echo device DCT pair pointer, TTI only. ) 

"ON" DCB address for spooler.* 

Link to TTR, TTI DCTs only. ) * 

"OFF" DCB address for spooler. 

Link to next spoolable device DCT (-1 terminates the chain). 



*set by RDOS. 
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Word 31, DCTOP: 
Word 32, DCTT3: 



Device queue starting address for operator messages. 

Temporary for operator message status word whose bits 
are defined as follows: 



Bit Meaning 

Set to 1 if "!" has been received. 

15 Set if "F" or "B" has been received. 



Word 7, DCTRD: 
Word 10 (no label): 

Word 11, DCSTR: 
Word 12, DCDST: 



Word 13, 
Word 14, 
Word 15, 
Word 16, 
Word 17, 
Word 20, 
Word 21, 
Word 22, 
Word 23, 
Word 24, 



DCCRQ: 



DCTSZ: 

DCTRL: 

DCTRN: 

DCTIN: 

DCTRS: 

DCNBK: 

DCTNS: 

DCTNH: 

DCTMN: 



Words 7-26, block transfer devices 

Read a Block. 

Used by the system to reconstruct the original device 
name upon the release of an EQUIValenced name. 

Device start routine. 

Set DST word (used for logical -to -physical disk block 
address computation). 



r 



n-r-ronl- r^nitf^ct rw-kint^-r 
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Routine to perform disk sizing (not used by MTA/CAS). 

Read last block. 

Read next block. 

Device initialization routine. 

Device release routine. 

Number of blocks on device. 

Number of sectors per track. 

Number of heads per unit. 

Hash frame size (one of the following): 



Moving Head Disk Type 

4047 
4048 
4057 



Frame Size (decimal) 

97 
193 

773 
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Aggregate Fixed Frame Size (decimal) 
Head Storage 

128K 7 

256K 13 

384K 23 

512K 31 

640K 41 

768K 47 

896K 53 

1024K 61 

1152K 71 

i280K 79 

1480K 89 

1536K 97 

1664K 103 

1792K 113 

1920K 113 

2048K 127 

(For a description of hashing under RDOS, see 
the Stand Alone Disk Editor manual, 093-000092, 
appendix B. ) 



Word 25, DCHMP: First slot in data channel map (mapped systems only). 

Word 26, DCHNM: Number of slots needed in data channel map (mapped 

systems only). 



n^ *Tr ^ "T* f* 
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CHAPTER 2 

OPERATING SYSTEM DEVICE IMPLEMENTATION 
GENERAL 

The list of I/O devices that are included as part of RDOS can be found in the RDOS 
User's Manual (093-000075). The user can, however, add device drivers to RDOS 
enabling the use of additional devices not furnished by DGC. All changes to RDOS 
to incorporate another device into the operating system should be made at the source 
program level. This section describes briefly the required changes to add a device. 
However, to completely understand the process of adding a device driver, the user ' 
may need to review listings of those RDOS programs mentioned later that require 
modification. The source programs required are available from DGC. 

During full initiatization of the system, names of all single -file peripheral devices 
in the system are added to the system file directory, SYS.DR . The device name 
will be entered only if the user has forced the driver to be loaded. The general 
procedure for adding a device driver is as follows: 

. declare a DCT entry for the device 

. enable entry of the device name in SYS. DR 

. update the system library 

. create a system queue entry 

. perform a system generation 

Sections following describe each of these steps. 

REENTRANT CODING AND SUBROUTINE LINKAGE 

One of the basic problems that arises in multi-level priority interrupt programming 
is that different levels require use of the same subroutine. This means that a higher 
priority interrupt could interrupt a lower priority one before it has completely 
used a common subroutine and argument pointers, temporary core storage locations, 
etc. , with the result that the return point for the lower level interrupt would be lost. 
Reentrancy, then, is defined as that property of a subroutine whereby use of the routine 
does not modify any of its locations; temporary values are stored outside the routine. 
Thus one user may be prevented temporarily from completing use of a reentrant 
routine because a higher priority user needs to use it. When the higher priority 
user has finished with the routine, the lower priority user completes his use of 
the routine at the point where he was interrupted. 

A method of reentrant coding using a system stack has been devised for RDOS to 
allow one subroutine to be entered at any time and from any interrupt level without 
loss of results. The operating system has several stacks used for the saving of 
state variables whenever a call to a system subroutine is executed. Each of these 
stacks is of a fixed length and stack frames are defined in the same manner for each 
stack. The stack frame is the basic increment of storage on a system stack. 
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REENTRANT CODING AND SUBROUTINE LINKAGE (Continued) 

Each system stack frame is 16 octal locations in length, and each of these locations 
has the following definitions: 



Displacement 


Mnemonic 


-1 


SP 



1 
2 
3 
4 

• 


RTLOC 

AGO 

ACl 

AC2 
TMP 


• 

13 
14 


MXTMP 
VRTN 



Contents 



Beginning of stack pointer (i. e. , pointer to 
RTLOC) 

Return location 

AGO 

ACl 

AG2 

General purpose subroutine storage 

ri 

Eighth and last storage location 
Overlay virtual address 

The system maintains a pointer for the current system stack in location 10, CSP. 
Linkage to save subroutine state variables on a system stack and restore these 
variables is provided by three routines contained in the RDOS utility package called 
GSUB. The save/restore routines are entitled SAV, SRTN, AND RTN, Calls to these 
routines are defined in the system parameters as being SAVE, SRTRN, and RTRN, 

GENERAL SUBROUTINE PACKAGE (GSUB, MGSUB) 

GSUB (MGSUB) is a core resident module which contains a series of other utilities 
for the system's use; GSUB is used by RDOS, and MGSUB is used by mapped RDOS 
(MRDOS). Each of these utilities is self-contained, i. e. , none of them calls out 
to other routines and none of them save variables outside a system stack frame 
(except the byte -handling and compare -word routines, as noted later). The following 
list gives the entry names and uses of each of the utilities in the GSUB or MGSUB 
module; starred modules ( *) are available only to mapped RDOS (MRDOS), and are 
found only in MGSUB. All other routines are available to both RDOS and MRDOS. 

NAME USE 

RTN Restore state variables, return the frame to the system 

stack. 
SAV Save state variables on a system stack. 

SRTN Restore current state variables and do not return a frame 

to the system stack; return to the immediate caller (not to 

the address stored in RTLOC). 
MVBYT Move byte string. 

LDCHR Load an eight bit byte. 

STCHR Store an eight bit byte. 

XOR Perform an exclusive or. 
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GENERAL SUBROUTINE PACKAGE (GSUB, MGSUB) (Continued) 



NAME 



USE 



CLEAR 

MVWD 

CMPWD 

DIVD 

DIVI 

SETFL 

FIDCB 

DLCK** 

DFLSH** 

DULK** 

MTMVB* 

MFMVB* 

MLDBT* 

MSTBT* 

MTMVW* 

MVMVW* 

MBMVW* 

MCLR* 

MBLK* 



Set a block of core to all zeroes 

Move a word string 

Compare two word strings 

Perform double precision integer divide 

Perform single precision integer divide 

Mask bits in a word to a one state 

Initialize a DCB 

Lock a directory process 

Flush a system buffer to disk, and erase if needed 

Unlock a directory process 

Move bytes with a mapped to_ address 

Move bytes with a mapped from address 

Mapped load byte (both byte pointers mapped) 

Mapped store byte (both byte pointers mapped) 

Move words with a mapped to address 

Move words with a mapped from address 

Move words with both addresses mapped 

Clear a block of words with a mapped starting address 

Convert user address to mapped address 



Except for RTN, SAV, and SRTN, each of these routines is called by means of an 
indirect call to a pointer within the calling routine containing the routine name, e.g. , 
a call to XOR would be performed in the following manner: 



.EXTN 
JSR 



XOR 
@.XOR 



.XOR: XOR 
SAV, RTN, and SRTN are used frequently in the operating system routines, so their 

entry points have been stored in the RDOS page zero area at locations 3, 4, and 11 
octal respectively. Calls to these routines are defined in the system parameters 
(PARS or MPARS) as follows: 



SAVE = 
RTRN = 
SRTRN = 



JSR@3 
JSR@4 
JSR @11 



** dual CPU shared-disk systems only 
* mapped systems only 
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GENERAL SUBROUTINE PACKAGE (GSUB, MGSUB) (Continued) 

Use of these mnemonics is sufficient to invoke the routine (except that SAVE must 
be preceded by one additional instruction as shown below). 

The following summarizes the inputs required by each GSUB routine and describes 
the outputs obtained upon return from each call. Each description (except SAV, 
RTN, and SRTN) presumes the existence of a pointer containing the routine name 
as Illustrated above. 

Save State Variables 

Calling Sequence: STA @ 3, CSP (CSP. the current stack pointer, is defined in PARS SR) 

SAVE 



CXitput: 



AGO, ACl, and AC2 are saved on a stack frame and are returned 
unchanged to the caller. AC3 contains the address of a new 
stack frame. 



Restore State Variables, Return a Frame 

Calling Sequence: P.TRN 

Output: 



Accumulators AGO through AC2 are restored; program control 
returns to the caller. A frame is returned to the system stack. 



Calling Sequence: SRTRN 



Output: 



Accumulators AGO through AC2 are restored; program control 
returns to the immediate caller (i.e. , not to the next higher 
level). The system stack pointer remains unchanged, since 
no frame is released. 



Move a Byte String 
Input: 



AGO, From byte pointer 
AGl, To byte pointer 
AC2, Byte count 



Galling Sequence: JSR @ .MVBYT 



Output: 



The specified byte string Is copied to the destination string 
area. MVBYT cannot be called during interrupt servicing, 
since MVBYT is not reentrant. 



2-4 



Licensed Material - Property of Data General Corporation 



Load/Store a Byte 
Input: 



Output: 



Exclusive, Or 



Input: 



ACl, Byte pointer 

AGO, Byte (right adjusted) 



Calling Sequence: JSR 



. LDCHR (or . STCHR) 



The specified byte is loaded or stored. STCHR cannot be 
called during interrupt servicing, since it is not reentrant. 



ACl, First operand 
ACO, Second operand 



Calling Sequence: JSR @ .XOR 



Output: 



The exclusive OR of the input operands is returned in ACl. 
Botii ACO and AC2 are restored to their input values. 



Clear a Block of Core 



Input: 



ACO, Number of sequential words to be cleared to zeroes 
AC2, Starting (lowest) address of the block 



Calling Sequence: JSR® .CLEAR 



Output: 



Move a Word String 
Input: 



The specified block of core is cleared. ACO through AC2 are 
restored upon exit. 



ACO, Starting address of the string to be copied 
ACl, Starting address to receive the string copy 
AC2, Number of words to be copied 



Calling Sequence: JSR @ .MVWD 



Output: 



The specified word string is copied to the specified receiving 
core area. ACO through AC2 are restored to their input values. 
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Compare Two Word Strings 
Input: 



AGO, Starting address of the first string 
ACl, Starting address of the second string 
AC2, Number of Words to be compared 



Calling Sequence: JSR @ .CMFWD 

success return 



failure return 



Output: 



The word strings are compared. K equal, control returns to the 
success return; otherwise, control goes to the failure return. 
ACO through AC2 are restored upon exit. CMPWD cannot be called 
during interrupt servicing, since CMPWD is not reentrant. 

Single/Double Precision Integer Divide 



Input: 



ACO, more significant dividend word for double precision divide 

only 

ACl, less significant dividend word 






Calling Sequence: JSR@ . DI VI (single precision) or 

JSR@ . DIVD (double precision) 



Output: 

Set/Reset Bits in a Word 



Quotient is returned in ACl, remainder in ACO. AC2 is restored 
upon exit. 



Input: 



ACO, operand word whose bits are to be set to 1 (or reset to 0). 
ACl, bit mask 



Calling Sequence: JSR@ .SETFL (-RSTFL) 



Output: 



Operand has all its bit positions set which correspond 
to bit positions set in the mask word. 
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Initialize a Etevice Cnntr nl Block 

Every 256-word disk block has a vinique identifier which might be used to locate the 
block within core memory if it has already been read from disk. This identifier consists 
of three elements, the first three entries in the device control block portion of a UFT: 



DCBDC or UFTDC 



oDUiN ur ur 1 UN 



DCT address (the core address of the DCT associated with the 

device containing the disk block) 
Unit number (the number of the disk unit, 1. e. , DPS, DKl, etc. ) 
Current Block Address (the logical address- -as opposed to 

physical address- -of the disk block) 



If the block has been read into core memory, and thus is resident within a system 
buffer, the above identifier triplet is sufficient to locate the block; if the block is 
not core resident, it can be read into a system buffer. 

Whenever either a file is to be opened on a channel or a directory is to be initialized, 
a PCB for the file or directory must be initialized via a call to the GSUB/MGSUB 
routine FIDCB. (A DCB is a portion of a UFT which describes information listed 
below; the other portion of a DCB describes user information about the file such as 
file name, last access time, etc.) 

DCB information for a file opened on a channel or for a directory is as follows: 



Directory 


File 


Mnemonic 


Mnemonic 


DCBDC 


UFTDC 


DCBUN 


UFTUN 


DCBCA 


UFTCA 


DCBCB 


UFTCB 


DCBST 


UFTST 



Core address of the DCT address for the device containing 

the file or directory. 

Specific unit number of the device (since there is only 

one DCT for each device controller). 

Current block address (logical block address of that 

portion of the file which was most recently accessed). 

Current block number ( i. e. , relative block number of the 

block within the file). 

Status of the file. The status is indicated by the following 

bits: 

Error detected 

I/O in progress 

The first write of the file has been made 

Directory is in use 

Opened for MTA read/write block (. MTOPD) 

File can be initialized (i. e. , is a directory 

other than the master directory). 

The file is being read 



1B15 
IB 14 
1B13 
IB 12 
1B9 
IBl 

IBO 
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Initialize a Device Control Block (Continued) 

DCBUC UFTEA If a directory, this word indicates whether the Fore- 

ground or Background initialized the directory, and 
how many files within the directory are open. If this 
is a file's DCB, UFTEA is the logical address of the 
portion of the system directory which contains this 
file's entry. 

The next logical block address of the file. 
The last logical block address of the file. 
The file's SYS. DR DCB address. This is needed so that 
the MAP. DR associated with this file can be accessed in 
the event the file changes size, and so that other elements 
in its UFD can be accessed (e.g. , the file use count). 

1X;BFA UFTFA The first logical block address of the file or directory. 

This is the first logical block of the file if it is contig- 
uously or sequentially organized, or the starting address 
of the index if tt is randomly organized (all directories 
are randomly organized). 

The DCB had a four-word extension if it is for a file opened on a channel: 



DCBNA 


UFTNA 


DCB LA 


UFTLA 


DCBDR 


UFTDR 



UFTBN The relative block number of that portion of the file 

currently being processed. 

UFTBP The byte pointer to the character position where pro- 

cessing in the file Is to resume. 

UFTCH Data words per block (376 for sequential files, 377 for 

random and contiguous files). 

UFTCN Active system request count. This count indicates how 

many requests have been made to the system to access 
the file. 

The calling sequence for the routine used to initialize a DCB is as follows: 



Input: 



Calling 
Sequence: 



ACO, First logical block address of the file or directory (the starting 

address of the index if randomly organized) 
ACl, The starting core address of the DCB describing the SYS. DR 

which contains the file or directory entry 
AC2, The starting core address of the DCB which is to be initialized. 

JSR @ . FIDCB 
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Initialize a Device Control Block (Continued) 

Output: DCBDCDCBUN, and DCBDR of the system directory containing the 

file or directory entry are copied into the new DCB. The first 
logical block address (input via ACO) is copied into DCBNA and 
DCBFA of the new DCB. The current block number contained in 
DCBCB is set to -1 (indicating that no processing within the file 
or directory has taken place), and the last address, current address 
and user count (DCBLA, DCBCA, and DCBUC) are cleared to zero. 
Lastly, the status of the file or directory is cleared, setting bits 12, 
11, 1 and only if they were set in the system directory containing 
this file or directory entry. 

Lock a Directory 

In systems with two CPUs and shared disk space, a directory lock-out mechanism 
is required so that only one CPU at a time can access and modify the contents of 
a directory. Failure to lock out a directory would render it impossible to retain 
current directory information for either CPU's use. Thus, in a dual CPU shared - 
disk environment when one CPU desires to access a directory, it must first lock 
the directory. After accessing the directory, the CPU must re-write the directory 
to disk and erase its copy of the directory from core memory, and finally it must 
unlock the directory so that the directory can again be accessed by either CPU. 

The format of this call is as follows: 

Input: AC 2 - DCB of director^' to be locked. 

Calling Sequence: JSR @ . DLCK 

Output: The directory status word, DCBST, is set to indicate the directory 

is locked (bit 12 is set to 1). 

Flush a System Buffer to Disk (and erase if a dual-CPU system) 

This routine flushes a system buffer by writing its contents out to disk. In the 
case of a buffer containing a directory, the updated copy of the directory is written 
out to disk. In a dual CPU environment, the core resident buffer is erased so the 
contents of the buffer must be re-read to be re-used by the system. 

The format of this call is as follows: 

Input: AC2 - Starting address of the system buffer to be flushed. 
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Flush a System Buffer to Disk ( and erase if a dual-CPU system) (Continued) 

Calling Sequence: JSR @ . DFLSH 

Output: The modified contents of the system buffer are returned to the 

host device, and the buffer's identity is erased. 

Unlock a Directory 

Having locked and modified a directory and then flushed the system buffer containing 
the directory, the directory must be unlocked so that the other CPU can access the 
directory. The format of this call is: 

Input: AC 2 - DCB of directory to be unlocked. 

Calling Sequence: JSR @ .DULK 

Output: The directory status word is set to the unlocked state. 

Move a Byte String (mapped system only) 

There are two move byte string routines for mapped systems; one routine accepts a 
mapped "to" address, while the other accepts a mapped "from" address. The result 
accomplished by both routines is identical: the specified byte string is copied to the 
destination area. Neither of these routines is reentrant. 

The formats of the two routines are as follows: 

1) Input: ACO, Mapped "from" byte pointer 

ACl, "To" byte pointer 
AC2, Byte count 

Calling 

Sequence: JSR @ . MFMVB 

2) Input: ACO, "From" byte pointer 

ACl, Mapped "to" byte pointer 
AC2, Byte count. 

Calling 

Sequence: JSR @ . MTMVB 



2-10 



Licensed Material - Property of Data General Corporation 

Load and Store Bytes (mapped system only ) 

There are two load/store byte routines for mapped systems; each routine accepts 
mapped byte pointer inputs only. The result accomplished by both routines is 
identical: the byte is loaded or stored where the mapped byte pointer specifies that 
it should be accomplished. Neither of these routines is reentrant. 

The formats of the two routines are as follows: 

1) Input: ACl, Mapped byte pointer 

AC2, Byte to be stored (right adjusted) 

Calling 

Sequence: JSR @ . MSTBT 

2) Input: ACl, Mapped byte pointer 

Calling 

Sequence: JSR @ .MLDBT 

Output: AC2, Byte (right adjusted) 

Move a Word String (mapped system only) 

There are three move word string routines for mapped systems. One routine accepts 
a mapped "to" address, another routine accepts a mapped "from" address, while the 
third accepts both a mapped "to" address and a mapped "from" address. The result 
accomplished by all three routines is identical: the specified word string is copied 
to the specified receiving core area. ACO through AC2 are restored to their input 
values. 

The formats of the three routines are as follows: 

1) Input: ACO, Mapped starting address of the string to be copied 

ACl, Starting address to receive the string copy 
AC 2, Number of words to be copied 

Calling 

Sequence: JSR @ .MVMVW 

2) Input: ACO, Starting address of the string to be copied 

ACl, Mapped starting address to receive the string copy 
AC2, Number of words to be copied 



2-11 



Licensed Material - Property of Data General Corporation 

Move a Word String (mapped system only) (Continued) 

Calling 

Sequence: JSR @ .MTMVW 

3) Input: AGO, Mapped starting address of the string to be copied 

ACl, Mapped starting address to receive the string copy 
AC2, Number of words to be copied 

Calling 

Sequence: JSR @ .MBMVW 

Clear a Block of Core (mapped system only) 

Mapped systems may clear a block of core memory to zeroes by means of a routine 
which accepts a mapped starting address. The format of this call is as follows: 

Input: AGO, Number of sequential (mapped) words to be cleared 

AC2, Starting (lowest) mapped address of the block 

Calling 

Sequence: JSR @ .MCLR 

Output: The specified core area is set to zeroes. AGO through AG2 

are restored upon exit. 

There also exist three sets of system I/O commands, modules entitled RINGl, RING2, 
and RINGS. Each of these modules is a system overlay, described in the following 
section. 

GENERALIZED I/O ROUTINES 

The I/O modules (RINGl, RING2, and RING3) provide a number of useful, general 
purpose reentrant routines for handling byte I/O from any device, on input or out- 
put, using the program interrupt facility. Entry names of the appropriate I/O 
routines are placed in each device driver dispatch table as required (see Device 
Control Table Structure, word 6). Each I/O module is a system overlay. 

The basic buffer philosophy is to maintain one or more fixed length buffers, with 
pointers and counters maintained to indicate the amount of data in the buffers and 
the current word input or output. A virtually unlimited number of buffers can be 
appended to the first buffer, with a four-word bead assigned to maintain status 
information and pointers for each additional buffer. 
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GENERALIZED I/O ROUTINES (Continued) 

An input device inputs to the buffer at interrupt time and outputs from the buffer at 
program base level. An output device inputs to the buffer at program base level 
and outputs from the buffer at interrupt time. 



^terrupt ^^ 
level 




interrupt 
» DP level 



Input Devices 



Output Devices 



Pointers PP and DP indicate the current slot in the buffer used for character storage 
or retrieval by the program and device respectively. Counters PC and DC indicate 
the current number of characters stored or retrieved from the buffers by the pro- 
gram and device respectively. The inputting of data to the buffer by the program 
or device halts temporarily when the last buffer has been filled. When the program 
or device retrieves the last buffer character, characters may once again be input 
to the beginning of the buffer. In the case of multiple buffers, each buffer becomes 
free to receive input as soon as the last character in that buffer has been retrieved 
by the program or device. 

When DC becomes equal to zero (after the last character in a buffer has been accepted 
by an output device), or when DC becomes non-zero (when a character is placed in a 
buffer by an input device), the task with pointer PP is readied. 

A virtually unlimited number of buffers can be appended to the first buffer, providing 
the facility for imformatted stream I/O and substantially reducing system overhead. 
Moreover, these additional buffers may exist in user program space as well as 
in system address space. Additional I/O buffers are appended to the first buffer 
by linking or stringing additional beads to the first bead. Each bead has a Unk to 
the next bead in the string; the terminating bead has a -1 link. 
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GENERALIZED I/O ROUTINES (Continued) 

One device bead consists of words 14 through 17 of the device's DCT. The structure 
of each bead is as follows: 

Word Link word 

Word 1 Data Pblnter (DP) 

Word 2 Data Count (DC) 

Word 3 Bead status/mode word 

Succeeding beads, used by system tasks like echoing, are linked to by previous bead 
links. The first bead in the string is pointed to by DCTQP of the device's DCT. 

The status /mode bit definitions for word 3 of each bead are as follows: 



Bit 



Meaning 



IBO Ready the task after each character 

IBl Ready the task upon request completion 

1B2 I/O request made by the foreground 

1B3 I/O request made by the bacl^ground 

1B4 Foreground operator message is outstanding 

XD<j Da.\-x\^j.\JuXlva \jjJCia.uOj. iiicooogc xo OuLOLcUlUlUg 

1B6 Device opened 

IB 14 Echo the character (TTI only) 

1B15 Request is completed (cleared by ENQUE routine) 



DCT 








Bead 4 


^ 


LINK 




Beado 


/ 


DP. 


-^ 


LINK 


/ 


DC, 


DCTQP 


BPc 


STATUS 




DCo 










STATUS 


> 




DCn 
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GENERALIZED I/O ROUTINES (Continued) 

A brief description of the major routines and their calling sequences follows. More 
detailed information can be obtained by reviewing the listing of RINGl, RING2, and 
RINGS. I/O Buffer management funtions are also provided by the RING I/O modules; 
these functions are discussed in the following section entitled 1/0 BUFFER MANAGE 



ME NT . It is important to note that although buffer input/output is in byte increments, 
devices transmitting larger data widths can use the same basic scheme. The card 
reader, for example, inputs its full word by calling for two consecutive byte inputs. 
Before discussing specific I/O routines, the following observations must be made 
about all I/O routines whose entries are used in device dispatch tables. 

First, system I/O routines are usually not called in the conventional sense. Rather, 
tiie names Oj. those routines which are required by a device driver are inserted into 
the appropriate displacements of that driver's dispatch table. If the routines provided 
by the I/O modules are inadequate, the user writing a device driver must write his 
own I/O routines (preferably making them core resident), and insert their names into 
his driver's dispatch table. User-written routines may either do some preprocessing 
of inputs to the . SYSTM call and then transfer control to one of the 1/0 routines, or 
the user-written routine may perform all the processing of inputs to the . SYSTM call. 
(Preprocessing of inputs to the system OPEN or CLOSE calls are not allowed. ) 

The following descriptions of routines in the I/O module also provide the parameters 
passed to these subroutines as input to the system. Users wishing to write their o\vn 
resident I/O routines may usually pass whatever parameters they wish in AGO and ACl. 
However, ordinarily the parameters passed in AGO and ACl are the same as were given 
in the user-issued . SYSTM calL The value passed in AC2 is always provided by the system. 

Open(OPNO, OPM) 

OPNO is used to open output devices, while OPNI is used to open input devices. OPNI 
issues an operator intervention message (if required), while OPNO issues the message, 
provides a form feed, and outputs leader if required. Both routines clear a device and 
initialize its OCT. This implies that the DCT has provided all necessary I/O buffer 
information as well as the seven words of variable storage (words 12-16 and 22-23 of 
the DCT. ) 

Input: 

AC2 - UFT address 

Calling Sequences: 1) Insert OPNO (OPNI) mnemonic into device dispatch table at 

displacement 0, OF. (Input is provided by the system. ) 
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Open(OPNO, OPNI) (Continued) 

Calling Sequences: 2) .EXTN OPNO (OPNI), OVLAY 
(Continued) JSR @ .OVLY 

OPNO (OPNI) 

error return (never taken) 

normal return 

.OVLY: OVLAY 

Users may do no preprocessing of inputs to OPNO (OPNI). H a user wishes to provide 
a special open routine for a device, the system OPNO (OPNI) routine caimot also be 
called for that device. 

Close (CLSO, CLSI) 

CLSO should be used only to close output devices. It waits until all output has settled, 
clears the column counter, clears the device, initializes the DCT, and provides 
trailer if required. Alternatively, CLSI should be used only to close input devices. 
It merely clears the device and initializes the DCT. 

Input : AC2 - UFT address 

Calling Sequences: 1) Insert either mnemonic CLSO or CLSI into the device 

dispatch table at displacement 1 (CF). (Input is provided 
by system. ) 

2) .EXTN CLSO (CLSI), OVLAY 
JSR @ .OVLY 
CLSO (CLSI) 

error return (never taken) 
normal return 

.OVLY OVLAY 

Users may do no preprocessing of Inputs to CLSO (CLSI). If a user wishes to provide 
a special close routine for a device, the system close CLSO (or CLSI) routine may 
not also be called for that device. 

Read Sequential (RDS) 

The device will be read, one byte at a time, until the byte count requested is satisfied. 
The data is not modified in any manner; this command is used for binary transfers. 

Input: AC 2 - UFT address 

ACl - byte count for RDS 
ACO - destination byte pointer 
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Read Sequential (RDS) (Continued) 

Calling Sequences: 1) Insert RDS mnemonic into device dispatch table at dis - 

placement 2 (RS). (Input is provided by system. ) 

2) .EXTN RDS, OVLAY 
JSR @ . OVLY 
RDS 

error return 
normal return 

.OVLY: OVLAY 

The error return is taken if an end of file or device timeout occurs, at which time 
error code EREOF is returned in AC2 and the partial byte count is returned in ACl. 
If the normal return is taken, the full byte count read is returned in ACl. 

Read Line (RDL ) 

This routine is used to transmit ASCII data and terminate after transmission of a 
carriage return, form feed, or null. All bytes transmitted are masked to seven 
bits. Line feeds and rubouts are unconditionally ignored. 

Input: AC2 - UFT address 

ACO - destination byte pointer 

Calling Sequence: 1) Insert RDL mnemonic into device dispatch table at displace- 
ment 3 (RL). (Input is provided by system. ) 

2) .EXTN RDL, OVLAY 

JSR@ .OVLY 
RDL 

error return 
normal return 



.OVLY: OVLAY 

The read byte count is returned in ACl, whether the error or normal returns are 
taken. The error return is taken and a system error code returned In AC2 for the 
following conditions: 

AC2 Mnemonic Meaning 

6 EREOF End of file or device timeout. 

22 ERLLI Line length exceeded 132 characters without a vaUd 

terminator. 
24 ERPAR Parity error intiie last character transmitted. 
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Write Sequential (WRS) 

Data is output in byte form to a device until the byte count has expired. The data 
is not altered in any manner. This mode is therefore the standard mode for binary 
output transfers. 

Input: AC2 - UFT address 

ACl - byte count for WRS 
AGO - source byte pointer 

Calling Sequences: 1) Insert mnemonic WRS into the device dispatch table at dis- 
placement 5 (WS). (Input is provided by the system. ) 

2) .EXTN WRS.OVLAY 

JSR@ . OVLY 

WRS 

error return 
normal return 



.OVLY: OVLAY 
The byte count written is returned in ACl. The error return is never taken. 



\UfH-o a T ino /\MTi T A 



This routine transmits ASCII data to the appropriate device and terminates after 
transmitting either a carriage return or a form feed. Termination also occurs 
upon detection of a null, but the null is not written. Checks are made of the device 
characteristics to determine whether to perform: 

1 . Parity on output 

2. Nulls after form feeds 

3. Line feeds after carriage returns 

4. Tab simulation (every 8 columns) 

5. Rubouts after tabs 

Input: AC2 - UFT address 

ACO - source bjrte pointer 

Calling Sequences: 1) Insert WRL mnemonic into device dispatch table at dis- 
placement 6, WL . (Input is provided by the system. ) 

2) .EXTN WRL, OVLAY 

JSR@ . OVLY 

WRL 

error return 
normal return 



•OVLY: OVLAY 
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Write Line (WRL) (Continued) 

The write byte count is return in ACl upon exit. The error return is taken after 132 
bytes have been written without detection of a valid terminator, and AC2 contains the 
following error code: 

AC 2 Mnemonic Meaning 

22 ERLLI Line limit exceeded. 

The RING I/O modules do not provide for random record reading or writing. 

Get Master or Default Directory Name (OMDIR/GDIRS) 

xin^uw xuuuui&o ^Jixoo LUC iicLiiic \JL tiic iiittoLcj. uixeuLuxy uevice (vjiviuiiv) or cne name oi 
the current directory (GDIRS). The master directory device is the primary or secon- 
dary partition which becomes the current directory after a full system initialization or 
a bootstrap; this directory also contains the system overlays. Since several versions 
of the operating system may be available for bootstrapping, different devices may 
become the master device. If the name of the current directory is requested, only the 
current directory name, not the colon delimiter and not the names of superior 
directories, is returned. The format of these calls is: 

Input: ACO-Byte pointer to 13_ byte user area 

o 

Calling Sequences: .EXTN OVLAY, GMDIR, GDIRS 

JSR @ .OVLAY 

GMDIR ; GET THE MASTER DIRECTORY NAME 

error return ; ATTEMPT TO OVERWRITE THE SYSTEM 

normal return 

JSR @ .OVLAY 

error return ; ATTEMPT TO OVERWRITE THE SYSTEIV 

normal return 

. OVLAY: OVLAY 
Two error codes may be returned: 

AC2 Mnemonic Meaning 

33 ERRD Attempt to overwtrte system (unmapped only), 

74 ERMPR Address outside address space (mapped only). 

I/O BUFFER MODULE (lOBUF) 



lOBUF is a core -resident module used by nearly all system drivers. One use of 
lOBUF is to execute certain types of I/O instructions; this permits the writing of 
reentrant drivers used by multiple devices (e.g. , a multiple TTY system requiring 
only one TTY driver). Another use of lOBUF is to provide common input/output 
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I/O BUFFER MODULE (lOBUF) (Continued) 

character device interrupt processing. lOBUF also provides routines to place a bead 
at the end of a bead string and to remove any bead from the string. Finally, lOBUF 
provides routines which perform common input and output character device interrupt 
servicing. 

The following list summarizes the entries in lOBUF: 

Entry Use 

CISER Common input interrupt service. 

COSER Common output interrupt service. 

DEQUE Remove any bead from the string. 

ENQUE Add a bead at the end of the string. 

FINP Partial input interrupt service.. 

IBUF Input a character to the I/O buffer. 

OBUF Output a character from the I/O buffer. 

PENQU Priority enqueue a bead. 

STOUT Initiate an output device, then provide interrupt service. 

XDIAC DIAC instruction processor. 

XDOAS DOAS instruction processor. 

XNIOC NIOG instruction processor. 

XNIOS NIOS instruction processor. 

XSKPB SKPBZ instruction processor. 

XDIAP DIAP instruction processor. 

XIBUF Priority enqueue a bead and input to buffer. 

Calls to any of the instruction processor entries (XDlAC, XDOAS, etc.) cause that 
instruction to be built (for the specific device in question), stored in the driver's 
"execute I/O instruction" area (pointed to by DCTEX of the device's DCT), and 
executed. Control is then returned to the caller. Calls to the instruction processors 
are issued solely by the system; specific calltypes depend upon the entries selected 
in the device dispatch table or in displacement DCTST of the Device Control Table. 

Common Input Device Interrupt Service (CISER) 

CISER provides interrupt service for character input devices. CISER is called 
either by placing the mnemonic CISER in word 2 of the input device's DCT or by 
means of the following calling sequence: 

Input: AC2 - DCT address 

Calling Sequence: .EXTN CISER 

JSR @ .CISE 
return to DISMIS 

.CISE: aSER 
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Common Input Device Interrupt Service (CISER) (Continued) 

returned in the device buffer. The input contents of ACl are lost; 
the input contents of AC2 are preserved. 

Common Output Device Interrupt Service (CQSER, STOUT ) 

COSER provides interrupt service for character output devices. STOUT initiates 
an output device, starts the device, then branches to COSER. Each routine can be 

called either hv nlar.ine its mn*^rnnni<- in Mm-r-H 9 /rtc^ic\ ^f ^.^ — r^r'T. 1 _^ 

the following calling sequence: 

Input: AC2 - DCT address 

Calling Sequence: .EXTN COSER (STOUT) 

JSR@ .COSE 
return to DISMISS 

.COSE: COSER (STOUT) 

Output: If a character is available for output in the device buffer, it is 
output. AC2 is preserved upon exit. 

Add a Bead to the String<ENQUE) 

ENQUE attaches a bead and I/O buffer to the end of the string of beads and buffers. 
This new bead becomes the last bead in the string, and is given a LINK of -1. 
ENQUE is called by means of the following calling sequence: 

Input: ACl - Bead address 
AC2 - DCT address 

Calling Sequence: .EXTN ENQUE 

JSR @ . ENQU 
return 

.ENQ: ENQUE 

Output: The bead and its associated buffer are attached to the end of the 
bead string. If the device is not busy, it is started. AC2 is 
unchanged upon exit. 

Terminate Bead from Head of List (DEQRQ) 

Like FINP, DEQRQ shares common code with CISER. DEQRQ's operations, how- 
ever, are limited to the following: Sets "Request Done" in the bead status word, 
readies a system task if necessary, and determines if any other beads are enqueued 
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Terminate Bead from Head of List (DEQRQ) (Continued) 

for the device. If other beads are enqueued, updates the bead pointer in DCTQP 
and restarts the device; otherwise clears the device. 

Input: AC2 - DCT address 



Calling 
Sequence: 


.EXTN DEQRQ 
JSR@ .DEQRQ 
normal return 




. DEQRQ :DEQRQ 


Remove a Bead from the String (DEQUE) 



DEQUE removes a bead from the bead string by setting the bead status word to 
"inactive" and adjusting the adjoining bead links, and by clearing the device 
associated with this string if the device is no longer active. The DEQUE calling 
sequence is: 

Input: ACl - Address of the bead to be removed 
AC2 - DCT address 

Calling .EXTN DEQUE 

ocqucuuc: joK ^ .uCj^u 

return 
•DEQU: DEQUE 

Output: The bead is inactivated and removed from the string. AC2 is 
unchanged upon exit. 

Partial Input Interrupt Service (FINP) 

FINP performs all functions accomplished by CISER without initially issuing a call 
to XDIAC followed by a restart of the device; FINP is thus an entry in CISER code 
which omits those two functions. FINP presumes that these functions have been 
performed elsewhere (as in the TTY and CDR drivers). 

Input: AC2 - DCT address 

Calling .EXTN FINP 
Sequence: JSR @ FINP 

normal return 

. FINP: FINP 
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Input a Character to the I/O Buffer (IBUF) 

IBUF places an eight-bit character in the currently available buffer slot. All book- 
keeping in the EXHT is maintained. 

Input: AGO - character (left byte ignored) 

AC2 - DOT address 

Calling Sequence: . EXTN BUF 

JSR @ .IBUF 
return - buffer full 
return - buffer not full 

.IBUF: IBUF 

Priority Enqueue a Bead (PENQU) 

PENQU places a bead and its buffer at the head of a bead string. If the device is not 
busy, it is started. 

Input: ACl- Bead address 

AC2-DCT address 

Calling Sequence: . EXTN PENQU 

JSR @. PENQU 
normal return 

.PENQU: PENQU 

Output: The bead and its associated buffer are attached to the beginning of the 
bead string. If the device is not busy, it is started. AC2 is unchanged 
upon exit. 

Priority Enqueue a Bead and Input to an I/O Buffer (XIBUF) 

XIBUF places a bead and its buffer at the head of a bead queue, and places an eight-bit 
character in the currently available buffer slot. All bookkeeping in the device's DCT 
is maintained. 

Input: ACO " Character 

AC2- Base address of a dummy DCT. The only portion of this 
DCT which is used by the routine is the bead portion of the 
DCT: displacements DCTQL through DCTQS. It is this 
bead which is placed at the head of the device queue. 
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Priority Enqueue a Bead and Input to an I/O Buffer (XIBUF) (Continued) 

CaUing Sequence: . EXTN XIBUF 

JSR @. XIBUF 

error return ;BUFFER FULL 
normal return 

.XIBUF: XIBUF 

Output a Character from the I/O Buffer (OBUF) 

OBUF retrieves an eight-bit character from position PP of the input buffer if one is 
available. AU bookkeeping in the DOT is maintained. 

Input: AC2 - DCT address 

Calling Sequence: . EXTN OBUF 

JSR @ . OBUF 
return - buffer empty 
return - buffer not empty 
.OBUF: OBUF 

Output: If the buffer was empty, a character is returned in AGO, bits 8- 15, 
I/O BUFFER MANAGEMENT 

As mentioned earlier, there is an I/O buffer for each device in the system, whose 
size may be increased or decreased by the addition or removal or buffer beads. At 
program base level (as opposed to interrupt level), users wishing to fetch a character 
from a buffer issue either an RDL or RDS call which, in turn, calls another routine, 
RCHR. RCHR, RDL, and REJS are disk resident I/O routines in RING I/O. The 
purpose of RCHR is to perform a generalized character fetch using the Device Control 
Table address to read a character from the physical device. Having received a 
character from the buffer, RCHR passes this character to the calling read routine. 

Each time RCHR is called, interrupts are disabled and OBUF is called. A character 
is fetched from the buffer, if one is available. (OBUF is a core resident routine in 
the lOBUF module, described earlier. ) If a character is not available In the buffer, 
the caller is suspended for a period of time less than or equal to the device timeout 
constant, DCTTO. If a timeout occurs, RTRN is executed; otherwise a loop back to 
the beginning of the RCHR sequence is made. 

At interrupt level, input devices input characters to a buffer by means of a call to 
CISER, also described above. 
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I/O BUFFER MANAGEMENT (Continued) 

A similar sequence of subroutine calls occurs for output devices. At program base 
level, a call to WRL or WRS results in a caU to ACHR which adds a character to the 
I/O buffer. ACHR is a disk resident I/O routine which calls IBUF to add a character 
to the buffer. 

RCHR makes an attempt to place the character in the I/O buffer by means of a call 
to IBUF. IBUF, described earlier, performs functions complementary to those of 
OBUF. If the buffer was not full, then the character is added to the buffer and thence 

— — J, „„^ ^w.^wv, v,u^t^v/a.^vi, ix |j«jooiuic/. u. tiic jjiuicx wfcia mil, a spool lor tne aata 

is started (if spooling is possible). Otherwise the system task is suspended for a 
period less than or equal to the device timeout constant. 

At the output interrupt level, COSER. is used to output a character to the device. 



rdlV 

RDS J 



-».RCHR 



-►OBUF 



Interrupt^ 

Service 

Routine 



■>CISER 



WRL^ 
WRS J 



■VACHR 



INPUT DEVICE 



-►IBUF 



Interruptj 
Service ■ 
Routine 



-^ COSER 



OUTPUT DEVICE 



j.vt^uLj.cvc a. v-.uaj. ctutcj. xxum ui K i/»j Dutier (RCHR) 

Retrieve a character from the buffer by means of a call to OBUF. 

Input: AC2 - DCT address 

Calling Sequence: . EXTN RCHR OVLAY 

JSR @ . OVLY 
RCHR 

timeout return 
normal return 
. OVLY: OVLAY 

Output: ACO- (if successful) character in bits 8-15. 
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Add a Character to the I/O Buffer (ACHR) 

Insert a character in the I/O buffer by means of a call to IBUF. 

Input: AC2 - DCT address 

AGO - character to be inserted 

Calling Sequence; .EXTN ACHR, OVLAY 

JSR @ .OVLY 
ACHR 

normal return 
. OVLY: OVLAY 

Declaring the DCT Address 

The last relocatable binary in system library RDOSC. LB is TABLE. TABLE 
contains the interrupt vector, named ITBL, discussed earlier. This vector is 
a linear array of DCT addresses which the system interrupt handler indexes 
by device code. The form of each ITBL entry is: 

.dvdPCT: dvdPCT ; OCTAL DEVICE CODE 

where dvd represents the DGC device mnemonic for each device, and dvdD CT is 
the DCT address of each device. Each DCT address must be declared as a 
normal externaL When adding an entry, the user can select any three -letter 
device mnemonic not used by a DGC device. 



2-26 



Licensed Material - Property of Data General Corporation 



Creating a Peripheral Device Entry in a Directory 

All peripheral device entries are created (and deleted) as required on every 
initialization of a disk device. All information necessary to accomplish this 
is in the system overlay CRSFS (revision 02 of RDOS) or SFTAB (revision 03), 
The information has the same format in either overlay and is as follows: 



Word 1: 



Bvte Dointer (overlav relative) to entrv name, 
packed left to right. 



Word 2: 
Word 3: 



File attributes of the required entry. 

Logical device code. This is the same as the 
physical device code except in cases where 
two or more logical devices share the same 
device code, such as $TTI/$TTR. 



The latter part of the overlay contains the directory entry text strings. The 
text string for the paper tape reader, for example, is as follows: 



PTRP 

ATPER+ATWB-ATCHA 

PTR 



NAME POINTER 

ATTRIBUTES 

LOGICAL DEVICE CODE 



. TXTM 1 
PTRP: . TKT /$PTR/ 
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Updating the System Libraries 

The RDOS 03 system libraries (RDOSA, RDOSB, RDOSC and the mapped versions) 
are arranged as shown in the following table. Differences between the RDOS 03 
and 02 revision libraries are indicated after the table. For a listing of the modules 
in other libraries, perform an analyze via the library file editor (LFE). To add a 
driver, insert it into any of the libraries (A,B, or C) provided it is inserted after 
SYSTE and before TABLE (MSYST and MTABL in the mapped versions). 

RDOS (MRDOS) 03 SYSTEM LIBRARY LIST 



Relocatable Binary Title 



INITl, 


INIT2. INIT3 


(MPWRF) 


(MAPZ) 




SYSTE 


(MSYST) 


OVLAY 


(OVLAY) 


FILIO 


(MFILI) 


BLKIO 


(BLKIO) 


OPPRO 


(MOPPR) 


TTYID 


(TTYID) 


TTYDR 


(MTTYD) 


DPMOD 


(DPMOD) 


GSUB 


(MGSUB) 


PLTID 


(PLTID) 


PLTDR 


(PLTDR) 


CDRID 


(CDRID) 


CDRDR 


(CDRDR) 


PTPID 


(FITID) 


PTPDR 


(Fi'PDR) 


PTRID 


(PTRID) 


PTRDR 


(FIRDR) 


LP132 


(LP132) 



LP180 (LP180) 

LP232 (LP232) 

LP280 (LP280) 

LPTID (LPTID) 



Primary Fmiction or Contents 

Full and partial system initializations. 

Mapped power fail handler. 

Mapped system page zero. 

. SYSTM call processor. 

System overlay handler. 

Disk fUe I/O. 

Block I/O management. 

Operator - Foregroimd /Background 

communications. 

Second Teletype driver. 

Tele tjTJe /video display driver. 

Dual processor module. 

General purpose subroutines and 

linkage. 

Second plotter driver. 

Incremental plotter driver. 

Second card reader driver. 

Card reader driver. 

Second high speed punch driver. 

High speed punch driver. 

Second high speed reader driver. 

High speed reader driver. 

132 column line printer characteristics 

word for $LPT. 

80 column line printer characteristics 

word for $LPT. 

132 column line printer characteristics 

word for $LPT1. 

80 column line printer characteristics 

word for $LPT1. 

Second line printer driver. 
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RDOS (MRDOS) 03 SYSTEM LBRARY LIST (Continued) 



Relocatable Binary Title 


LPTDR 


(LPTDR) 


lOBUF 


(lOBUF) 


M17DB 


(M17DB) through MOODB (MOODB) 


C17DB 


(C17DB) through COODB (COODB) 


MTADR 


(MMTAD) 


MTAID 


(MTAID) 


MTADC 


(MTADC) 


CTAID 


(CTAID) 


CTAnC 


(CTADC) 


STK09 


(STK09) through STKOO (STKOO) 


DKDCB 


(DKDCB) 


DKIDB 


(DKIDB) 


DSKDR 


(MDSKD) 


DSKDC 


(DSKDC) 



DSKID (DSKID) 

DF7DB (DP7DB) through DPODB (DPODB) 

DKPDR (MDKPD) 
DKPDC (DKPDC) 

DKPID (DKPID) 

MCTID (MMCTl) 
MCTDC (MMCTD) 
MCADR (MMCAD) 
QTYDR (MQTYD) 
P31DB (P31DB) through POODB (POODB) 

PWRFL 

INTD (MINTD) 

PANIC (MPANI) 

TABLE (MTABL) 



Primary Function or Contents 

Line printer driver. 

I/O buffer handlers. 

Magnetic tape device control blocks. 

Cassette device control blocks. 

Magnetic tape/cassette driver. 

Second magnetic device control table. 

Magnetic tape device control table. 

Second cassette device control table. 

Cassette device control table. 

System stacks nine through zero. 

Fixed head disk DCB, first controller. 

Fixed head disk DCB, second controller. 

Fixed head disk driver. 

First fixed head disk device control 

table. 

Second fixed head disk device control 

table. 

Moving head disk DCBs for units 7 

through 0. 

Moving head disk driver. 

First moving head disk device control 

table. 

Second moving head disk device control 

table. 

Second MCA device control table. 

First MCA device control table. 

MCA driver. 

Asynchronous multiplexor driver. 

Partition/subdirectory DCBs 31 

through 0. 

Unmapped power fail handler. 

Interrupt determinator. 

System PANIC handler. 

Tables section. 



The major differences between the RDOS 03 and 02 libraries are as follows. First, 
RDOS 02 does not support the multiprocessor communications adapter; thus modules 
MCTID (MMCTl) and MCTDC (MMCTD) are not found in the 02 libraries. Secondly, 
the system stack modules were entitled PSTK5 through PSTKl in RDOS 02. Finally, 
full and partial initialization was performed by module INIT in RDOS 02. For more 
information about the contents of the RDOS 02 libraries, perform an analyze. 
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Creating a System Queue Entry 

A system queue must be created for the device within the device driver. The structure 
of this entry is as follows: 



. ENT dvdQ 



dvdQ: .BLK 2 

100000 
dvdDCT 



USED TO POINT TO DCT AND UFT 
SYSTEM STACK IS REQUIRED 

DCT ASSOCIATED WITH QUEUE 



. BLK SGLN- . -HdvdQ ;SYSTEM STORAGE AREA 

The address of this queue entry must be defined in the system queue table (SQ) in the 
TABLE module. 

An example of a system queue entry for the paper tape reader is as follows: 

PTRQ: .BLK 2 

100000 
PTRDCT 
.BLK SQLN-.+PTRQ 

System Generation 

Invoke the SYSGEN save file and answer all queries. Determine the additional space 
necessary to load the new, user driver plus any additional words added to the system. 
Before creating the new operating system save file, the value contained in the file 
named NREL should be adjusted down by the additional amount of space required by 
the new device driver. 

To insure that the driver will get loaded from the library at system generation time, 
a small program should be written and loaded at this time ahead of the RDOSA. LB 
(MRDOSA. LB) library. The program could take the following foirm: 

. EXTN dvdDC 
.END 

and the relocatable binary called DUMMY. RB . 

File SRLDR. CM (SRLDRl. CM, MSRLDR. CM, or MSRLDRl.CM) must be modified so that 
DUMMY appears as an entry after @NREL@, 

Invoke SRLDR. CM (SRLDRl, CM, etc. ) to build the new RDOS system 
PRACTICAL HINTS FOR SYSTEM DEVICE DRIVER IMPLEMENTATION 

This section is devoted to a line -by-line examination of an actual RDOS driver, the 
high speed paper tape reader. 
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Elements Required in User-Written I/O Routines 

User device drivers may perform I/O in three ways: 

1. By using system routines, placing the routine names in the user 
device dispatch table. 

2. By appending some pre-processing instructions to an existing 
system routine. 

3. By substituting system I/O routines with user written routines, and 
either placing these routines in-line or by placing the routine names 
in the dispatch table. 

The first case, placing a system I/O routine name in the device dispatch table, is 
the easiest to implement. 

In the second case, where the user wishes to do some pre-processing of input para- 
meters,* then transfer control to a system routine, the following steps must be 
followed. The steps in this example illustrate the case where RDL is the system 
call which will have instructions appended to it by the user: 

1. Perform a SAVE before calling RDL. 

2. Ensure that RDL is passed its requisite parameters. These are the 
UFT addresses in AC2 and the destination byte pointer in ACO. Use 
the RDL calling sequence defined earlier. 

3. Perform an RTRN upon return from the call to RDL. 

In the last case, a user wishes to write an I/O routine which will be used instead of 
a system routine (perhaps placing this routine in his driver module). The following 
example sketches the essential elements of such a routine (leaving blank the I/O 
code sequence proper): 



;SAVE CALLER'S AC'S 
; FETCH INPUT ACO 

;TEST FOR END OF FILE ERROR 





.ENT 


RDLl 


RDLl: 


STA@ 
SAVE 


3,CSP 




LDA 

• 


0, OACO, 3 




MOV# 


2,2,SNR 




JMP 

• 


TIMEOUT 




• 

ISZ 


ORTN, 3 




RTRN 




TIMEOUT: 


LDA 


2, ERROR 




STA 


2,OAC2 




RTRN 




ERROR: 


EREOF 





;G0 TO NORMAL RETURN 

;GET ERROR CODE 

;RETURN ERROR CODE IN AC2 



except upon opening or closing a device. 
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Examination of a System Device Driver 

This section is devoted to a line-by-line examination of an actual RDOS driver, the 
high-speed paper tape reader driver (PTRDR). 

Following are the first 11 lines of the RDOS paper tape reader driver: 



ikl0fe)2 PTRDR 
01 



• 



TITLE PTRORV t PAPER TAPE READER DRIVER 



»^ ,NREL 

"6 .ENT PTROC,PTRO,PTRDT,PRSAV,PTREX 

'»'* .EXTN RDS,0PNI,CU8I,R0L fCOMMANQ ENABLE 

"59 .EXTN XNIOS lEXECUTE I/O IN8TRS 

1» .EXTN CISER IINTERRUPT SERVICE 



The entries PTRDC and PTRQ on line 6 define the PTR Device Control Table address 
and the system queue entry respectively. PTRDT, PRSAV and PTREX define the dis- 
patch table address, start of the save state routine, and the execute - I/O instruction 
routine respectively. PTRDT, PRSAV and PTREX are entered so that they can be 
'referenced by PTRID, the second paper tape reader driver. 
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Examination of a System Device Driver (Continued) 



12 

i4 
15 
16 
17 
IB 
19 
20 
21 
22 
23 
24 
25 
26 
27 
2S 
29 
iid 
31 
32 
33 



I PAPER TAPE READtR DEVICE CONTROL TABLE 



00000 
00001 
00002 

00003 
00004 
00005 

(£0006 

00007 
00010 

00011 
000U 
00013 
00014 
00015 
00016 

00017 

00020 
00021 
00022 
00024 



000110'PTHOCT: 

000577 

177777 

000404 
000012 
000065' 
000120 ' 

177777 

000100 

000052" 

000001 

00fc00l 

000001 

000001 

000001 

040001 

k400014' 
177777 

000002 
000002 



PRSAV 

MSPTR*MSTT 

CISER 

OCIDI*DCPC 

PTR 

PTREX 

M <» *% A «l 

P I r(u I 
XMOS 
PTRSZ*2 
PTRBF*2 
.BLK 1 



I SAVE MACHINE STATE 
I + MSTT0*M8PTP*MSl.PT*M8CDR*HS0SK*MSDKP f M^SK 

IINT SERVICE 
K 1 CHARACTSRISTIGS 

yOEVlCE CODE 

lEXECUTE 10 INSTRUCTION 



m^mntm^Lj m t at tr 



A rsiN B c e c 



,BLK 
.BLK 
,8LK 

,BLK 



iBi*iBi5 

.-4 

'I 

.BUK 2 
2 



f READER START ROUTINE ADDRESS 

I BUFFER SIZE 

f BUFFER FIRST BYTE ADDRESS 
IPR08RAM BYTE COUNT 
IPROGRAM BYTE POINTER 
lOEVlCE BEAD I.INK 
IDCVICE DATA BYTE POINTER 
IDEVICE DATA COUNT 

IBEAD STATUS wORD- XNIT TQ REQUEST OONi 
IBEAD ADDRESS 
IREQUEST QUEUE POINTER 
IDEVICE TEMPS 
fTIME OUT IN SECONDS 



Locations through 24 (lines 14-33) comprise the paper tape reader Device Control 
Table (DCT). PRSAV is the start of the state save area (this area is defined later on). 
Word 1 (line 15) defines the interrupt mask. The paper tape reader mask word, 577, 
prevents all devices with mask bit assignments 7 and 9 - 15 inclusive from interrupting 
the reader (thus preventing chatter). Word 2 specifies that reader interrupt service is 
performed by CISER, the common interrupt service routine found in the lOBUF module. 
Words 4 and 5 define the device characteristics and device code; DCIDI indicates that 
the reader requires operator intervention, while DCPCK indicates that the reader is a 
device requiring an even parity check on input. 

PTREX, word 5, is a pointer to the reader I/O execute instruction area. This area will 
be seen later. PTRDT points to the reader dispatch table; this table will be seen on 
page 2 of the reader driver Usting. XNIOS, line 21, is an entry in the lOBUF module 
and will be resolved by the loader. XNIOS starts the reader. 

Words 10 and 11 (lines 22 and 23) define the size of the reader buffer in bytes (100) and 
a pointer to the first byte in this buffer. Words 12 and 13 (lines 24 and 25) are allocated 
for the program byte count (PC) and the program byte pointer (PP) respectively. 

Words 14 through 17 (lines 26-29) allocate a bead frame for the reader buffer, and 
iiiitialize the bead status word to "request done. " Word 20 contains the address of the 
bead allocated by words 14-17, and word 21 contains the pointer to the currently active 
bead. This word is initialized to -1; 
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Examination of a System Device Driver (Continued) 

Words 22 and 23 (line 32) are allocated for the first and second temporaries for 
device control. The last word in the DCT, word 24, contains the reader timeout 
constant, 2 seconds. 



34 
35 
36 
37 

38 
39 
Aid 
41 
42 
43 
44 
45 
40 
47 

4a 



Line 35 defines the size of the reader buffer in words, and line 37 allocates the 
buffer space. 

Lines 39 through 41 define the I/O instruction execution area defined for the paper 
tape reader. Location PTREX receives the I/O instruction constructed by lOBUF, 
and after executing that instruction control is returned to the interrupt service 
routine by either the second or third instructions, lines 40 and 41 (depending upon 
whether that instruction causes a skip or not). 

PTRQ (entered previously on line 6) defines the system queue entry for the paper 
tape reader. 



M00040 PTR5Z« 40 

00025 «0eie'5ll40 PTRSFI ,BLK 

00665 '0000ifj0 PTRfcXJ 

00066»001400 JMP 0,3 

00067»00l40l Jf*.p 1,3 



PTRSZ 



f BUFgR SIZE 

I RESERVE THE BUFFIR SPACE 



0PH57y '000002 ptrq: 

0(5072' 1M0000 

00073't^00000» 
00(ii74 'i'.0t0i4 



,8l.K 2 
100000. 
PTROC 
.BLK SQt.N< 



.♦PTRO 



Finally, on page 3 of the driver listing we find the machine save state area definition, 
PRSAV, and the paper tape reader dispatch table, PTRDT. This table provides entries 
to open and close the reader and to perform read line and read sequential operations: 



10 

01 
02 
03 
04 
03 
06 
07 
06 
09 
10 
11 
12 
13 
14 
15 
16 
17 
18 



0^13 PTRUR 
001 10' 1^0001 « PHSAV: ,BLK ISVLN 

> OfcFINE THfc PAPER TAPE READER D 



£50120 
00121 
i^i9122 
00123 
00124 
0«12b 
0012b 
00127 
00130 
00131 
00132 
00133 



177777 PTROTJ OPNI 



177777 

177777 

177777 

177777 

177777 

177777 

177777 

177777 

fe*0Kl20 ' 

(t:'ii)tfil31 ' 

177777 



CLSI 

RDS 

ROL 



0PM 
OPNI 

'1 

,EM[3 



SAVE MACHINE STATE 

SPATCH TABUE 

PTR OPEN 

PTR CLOSE 

PTR READ SEQUENTXAl 

PTR READ LINE 

PTR READ RANDOM 

PTR WRITE SEQ 

PTR WRITE LINE 

PTR WRITE RANDOM 

PTR OPEN FOR APPENOJNS 

PTR READ ONLY OPEN 

PTR EXCLUSIVE OPEN 

PTR TRANSPARENT OPEN 
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Examination of a System Device Driver ( Continued) 

The read random record and all write commands are illegal for the paper tape 
reader. This is indicated by the placement of -1 in these positions of the 
dispatch table. 

Following is the cross-referenced sjonbol listing for the paper tape reader 
driver: 



06104 PTROK 










CIStK 


000it<(^2 


1 XN 


2/10 


2/16 




CLSI 


?0P1121 


' XN 


2/08 


3/07 




OPNI 


00^)132 


' XN 


2/06 


3/06 


3/15 


PRSAV 


m^iiid 


' En 


2/06 


2/14 


3/02 


PTrtBf 


m7>vi2i3 




2/23 


2/37 




PTRUC 


0i?0(i;0((! 


' EN 


2/06 


2/14 


2/46 


PT«OT 


000120 


EN 


2/06 


2/20 


3/06 


PTWEX 


0ii0hja5 


EN 


2/06 


2/19 


2/39 


PTRQ 


00^m7k5 


EN 


2/06 


2/44 


2/47 


PTKSZ 


m^Vi4l6 




2/22 


2/35 


2/37 


R!)L 


0i:t012o 


XN 


2/08 


3/09 




ROS 


0fo0122 


XN 


2/08 


3/08 




XMUS 


0^0007' 


XN 


2/09 


2/21 





3/16 
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CHAPTER 3 

USER PROGRAM SERVICED INTERRUPTS 

SERVICING USER INTERRUPTS 

Special user devices may be identified either at the time an RDOS system is 
loaded or at run time. This chapter describes the procedure for identifying 
a user device at run time and for creatine a user clock driven b" the s^^stem 
real time clock. The considerations given for identifying a user device are 
common to both single and multitask environments; the user clock facility may 
also be used in both task environments. 

Upon detection of an interrupt request, the system will be dispatched through 
the device interrupt vector table, . ITBL (see Chapter 1). In this table are 
pointers to Device Control Tables (DCTs) for devices established at system 
initialization time, whether system or user devices. Chapter 1 describes 
the structure of system DCTs. 

User Device Driver Implementation at Run Time 

In order to identify a user device to the system at run time, the user must 
provide a three -word DCT as an interface between the system interrupt 
dispatch routine and the user-interrupt servicing routine. The structure and 
mnemonic assignments of this three-word table are as follows: 

Mnemonic Purpose 



DCTSV Pointer to an 8 -word state save area. 

1 DCTMS Interrupt service mask. 

2 DCTIS Interrupt service routine address. 

DCTSV is a pointer to an eight word state variable save area reserved by the 
system for compatibility with RTOS. DCTIS is a pointer to the routine which 
services this particular device interrupt. DCTMS is the interrupt mask* that 
the user wants to be ORed with the current interrupt mask while in the user 
interrupt service routine. This mask establishes which devices--if any--will 
be able to interrupt the currently interrupting device. 



*See "How to Use the Nova Computers, " Section 2.4. 
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User Device Driver Implementation at Run Time (Continued) 

Upon transferring control to the user interrupt service routine, the system will 
ensure that ACS contains the return address required for exit from the routine, 
and that AC2 contains the address of the DCT upon exit from the routine. In 
revision 02 of RDOS, for unmapped systems, exit is accomplished by a jump to 
the return address specified by ACS upon entry. Rescheduling does not occur. 
For mapped systems under revision 02 of RDOS, return and rescheduling is 
accomplished by loading integer 3 into ACO, then by issuing instruction NIOC MAP. 
In revision 03 of RDOS, task call , UIEX is issued, and rescheduling may occur 
as an option. 

All multitask environment activity ceases at the moment that a user device 
interrupt is detected. Nonetheless, it is possible for a user to communicate a 
message to a task from a service routine. If the task in question has been 
expecting such a message through issuance of a , REC and is now in the suspended 
state, issuance of the message via . DCMT will cause that task to be readied 
even though multitask activity is in abeyance. If no task has issued a . REC for 
such a message, . IXMT simply posts the message and takes no ftirther action. 
For more information on communicating to tasks from a user interrupt service 
routine, see Chapter 5 of the RDOS User's Manual, 093-000075-04. 

In addition to . IXMT, certain other task calls can be issued from a user 
interrupt routine or user power fail routine. A complete list of these task calls 
follows: .IXMT, .SMSK, .UIEX and .UPEX. 

All user devices are removed from the system when either a program swap or 
chain occurs. Receipt of a user interrupt on a new program level (which has not 
identified the user device) will cause the system to clear the device's done and 
busy flags and then return to normal program execution. 

Identify a User Interrupt Device (. IDEF ) 

In order to introduce to the system those devices (not identified at SYSGEN time) 
whose interrupts the system is to recognize, the system call . IDEF must be 
issued. This places an entry in the interrupt vector table. ACO contains the 
device code of the new device. ACl contains the address of the new device's 
DCT. In unmapped systems, this address must exceed 4008; in mapped systems, 
bit of this address is set if the device is a data channel device. In mapped 
systems with a device using the data channel, AC2 contains the number of IK 
core memory blocks which will be needed by the data channel map. This number 
will be one larger than the integer number of 1024io word blocks used for data 
channel core buffers. The format of this command is: 
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Identify a User Interrupt Device (.. IDEF) (Continued) 

. SYSTM 
.IDEF 
error return 



Possible error messages are: 

AC.2 Mnpmnnir 



36 



ERDNM 



45 ERIBS 

65 ERDCH 

74 ERMPR 



Mpanino- 



Illegal device code (> 778). Device code 
778 is reserved for the power monitor /auto 
restart option. 
Interrupt device code in use. 
Insufficient room in data channel map. 
Address outside address space (mapped 
systems only). 
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Exit from a User Interrupt Routine (.UIEX) 

Upon a user device interrupt, AC3 will contain the return address upon entry 
to the user routine. In both revision 02 and 03 of RDOS, exit may be accom- 
plished by either a jump to the return address specified by ACS upon entry to 
the user routine, or by loading "3" into AGO and then by issuing an NIOC MAP, 
In revision 03 of RDOS, however, task call .UIEX is issued. 

In unmapped systems, before issuing task call . UIEX AC3 must be loaded with 
the return address that it contained upon entry to the user routine. In mapped 
systems, the contents of ACS are ignored when , UIEX is issued. In both mapped 
and unmapped systems, rescheduling of both the task and program environment 
(if a foreground/background system) will occur upon exit only if ACl contains 
some non-zero value. 

The format of this call is: 

ACl - Zero only if rescheduling is to be suppressed. 
ACS - Return address upon entry to routine (unmapped systems 
only). 

.UIEX 

Control returns to the point outside the user routine which was interrupted by 
the user device. No errors are possible from this call. This call can be 
issued in a single task environment. 

Remove User Interrupt Servicing Program (.IRMV) 

To prevent the system's recognition of user interrupts which have been previously 
identified by the . IDEF command, the . IRMV command is issued. Required input 
to this call is the user device code corresponding to the device which is to be 
removed. 

The format of this call is : 

ACQ - Device code. 

. SYSTM 
.IRMV 
error return 
normal return 
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Remove User Interrupt Servicing Program (.IRMV) ( Continued) 
One possible error message may be given. 
AC2 Mnemonic Meaning 



36 



ERDNM 



Illegal device code ( >778) or attempt to 
remove a system device (i.e., one 
established at SYSGEN time). 



Sat the Data Channel Map (. STMAP) 

User devices employing the data channel in mapped systems must issue a 
system call to set up the data channel map. (A separate map is maintained by 
the mapping hardware for data channel usage. ) This call sets up the data channel 
map for the user device and returns in ACl the logical address which should be 
sent to the device. Required inputs to this call are the user device code in AGO, 
and in ACl the starting address of the device buffer in user address space. 



The format of this call is: 

.SYSTM 
.STMAP 
error return 
normal return 

This call is a no-op when issued in unmapped systems. In mapped systems, 
two possible error conditions may occur. 



AC2 

36 

74 



Mnemonic 

ERDNM 
ERMPR 



Meaning 

Device code not previously identified as a data channel device. 
Address outside address space (mapped systems only). 
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Modifying the Current Interrupt Mask (.SMSK) 

RDOS 03 and subsequent revisions contain a task call which permits the current 
interrupt mask to be modified. Whenever a user interrupt occurs, the interrupt 
mask is ORed with the mask contained in DCTMS of the user DCT to produce the 
current interrupt mask. Nonetheless, it is possible in the service routine 
to produce a current mask which ignores the contents of DCTMS, producing a 
new mask which is the logical OR of the old mask (upon entry to the service 
routine) and a new value. This is done by task call . SMSK, whose format is as 
follows: 

AGO - New value to be ORed with old mask. 

.SMSK 
normal return 

There is no error return possible from this call. This call may be issued in a 
single task environment. 



WRITING USER POWER FAIL SERVICE 

RTOS provides software support for the power fail/automatic restart option. 
Upon detection of a power loss, the system transfers control to a power fail 
routine which saves the status of accumulators through 3, the PC and Carry. 

When power is restored, if the console key is in the LOCK position, the message 

**POWER FAIL** 

is output on the system console and the state variables are restored before 
control resumes operation at the point where it was interrupted. If the console 
key was in the ON position when input power failed, the user must set the 
console switches to all zeroes (down) and START must be pressed when power is 
restored. This causes the console message to be output and state variables to 
be restored as when the key is in the LOCK position. 

The following system devices are given power-up restart service by RDOS: 
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WRITING USER POWER FAIL SERVICE (Continued) 

paper tape readers/punches 

Teletypes 

quad multiplexors 

card readers 

line printers 



Character devices may lose one or more characters during power up. Each card 
reader may lose up to 80 columns of information on a single card. Line printers 
may lose up to a single line of information. Since power up service for disks 
includes a complete re-read or re -write of the current disk block, no disk 
information is lost, although moving head disk units will require 30 to 40 seconds 
before disk operations can continue. Devices requiring operator intervention 
(like line printer, card readers, etc. ) must receive such action if power was 
lost for an extended period of time. No power up service is provided for 
magnetic tape or cassette units. 

Power up service for special user devices (or for magnetic tape or cassette units) 
must be provided by the user via the system call . IDEF. The format of this 
call when used to identify user power up service is as follows: 

ACO - 778 

ACI - Starting address of user power up service 

routine. 

. SYSTM 
.IDEF 

error return 
normal return 

The error return is never taken. 

Exit from a user power-up service routine for mapped systems under RDOS 02 
forces rescheduling, and is accomplished by loading integer 4 into ACO, then 
by issuing the instruction NIOC MAP. Unmapped revision 02 systems must 
exit from user power-up service routines by jumping to the return address 
specified by ACS, and this also forces rescheduling to occur. 

Exit from user power-up service routines under revision 03 of RDOS may be 
performed in the same manner as for revision 02. Alternatively, revision 
03 provides a task call . UPEX, for performing this exit. 
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Exit from a Power Fail Service Routine (. UPEX) 

Upon entering a user power fail service routine, AC3 will contain the address 
required for exit from the routine. To return from the user power fail routine 
in an unmapped environment, AC3 must be loaded with this return address and 
task call . UPEX must be issued. In mapped systems, the value input in ACS 
when this call is issued is ignored. 

The format of this call is : 

ACS - Return address upon entry to the routine (unmapped systems 
only). 

.UPEX 

Control returns to the location which was interrupted by a power failure. 
No error return or normal return need be reserved. . UPEX can be issued in 
a single task environment. Note that this call can be issued only in revision 03 
and higher revisions of RDOS. 

USER PROGRAMMED CLOCK 



Two system commands, .DUCLK and .RUCLK, are available to permit the 
definition and removal of a user clock driven by the system's real time clock 
(RTC). This user clock generates interrupts at user-definable intervals. When 
one of these intervals expires, control goes to a user -specified routine outside 
the current single or multitask environment. No task calls (other than . IXMT) 
may be issued from this interrupt servicing routine. 

Define a User Clock (.DUCLK) 

This command permits the definition of a user clock. When an interrupt is 
generated by this clock, the task scheduler and multitask environment- -if any-- 
are placed in suspension, and control goes to a user -specified routine. The 
format of this call is: 

ACO - Integer number of RTC cycles between each 

user interrupt. 
ACl - Address of user routine to receive control. 

.SYSTM 
.DUCLK 
error -return 
normal return 
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Define a Hspr Pinrk < r^rir'T t^\ /r^. -.-.-.<-;, -.-.-..-.a\ 

If the error return is taken, the following error code is issued: 

AC2 Mnemonic Meaning 

45 ERIBS A user clock already exists 

Upon a user clock interrupt, AC3 will contain the address of the return upon entry 
to the user routine. Exit from the user clock routine can be performed in all 
unmapped versions of RDOS by jumping to the return address specified by AC3 
upon entry to the routine. If this means of exit is selected, rescheduling will 
not occur . In the mapped version of RDOS 02, AGO must be loaded with "2" and 
instruction NIOC MAP must be executed, hi rev. 03 and higher revisions of RDOS, 
task call . UCEX can be issued to provide a means of exiting from the clock routine; 
optional rescheduling of the task environment is permitted if this means of exit is 
selected. 

Upon a user clock interrupt, AC3 will contain the address of the return upon 
entry to the routine specified in , DUCLK. To return from the user clock 
routine in an unmapped environment, ACS must be loaded with the return 
address that it contained upon entry to the routine and task call . UCEX is 
issued. In mapped systems, the value input in ACS when this call is issued 
is ignored. In both mapped and unmapped systems, rescheduling of both 
the task environment and the program environment (if a foreground/background 
system) will occur upon exit only if ACl contains some non-zero value. 

The format of this call is : 

ACl - Zero only if rescheduling is to be suppressed. 
ACS - Return address upon entry to routine (unmapped 
systems only). 

.UCEX 

Control returns to the point outside the user routine which was interrupted 
by the user clock. No errors are possible from this call. This call can be 
issued in a single task environment. Note that this call can be issued only in 
revision 03 and in higher revisions of RDOS. 

Remove a User Clock (.RUCLK) 

This system command removes a previously defined user clock from the system. 
The format of this call is : 
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Remove a User Clock (.RUCLK) (Continued) 

. SYSTM 
. RUCLK 
error return 
normal return 

The error return must be reserved, but it is never taken. 

EXAMPLES OF USER SERVICED INTERRUFTS 

This section illustrates two implementations of user-written interrupt servicing 
programs for devices not incorporated into the system at SYSGEN time. 

Analog to Digital Converter 

The first of the two illustration programs is an analog to digital converter driver, 
found on page 3-12. This driver consists of four subroutines which can be called 
from a user program, the interrupt servicing subroutine, and a Device Control 
Table. The following is a line by line analysis of the A/D driver. 

j_.j.iico \j - i.yj aauw uictt Liic tiLic ui uic uiivci iH n.Lur.v, iiicLi. loux entry pomes exist 
for user access of this driver, and that the driver program is normal relocatable 
(i. e. , that it does not use any page zero locations). Line 15 gives the address of 
the Device Control Table which is defined in lines 17-19. This is an abbreviated 
DCT as discussed earlier. 

The first location in the DCT (line 17) points to an 8 -word state save area defined 
on line 30. The second entry in the table is the hardware mask that is set while the 
A/D interrupt is serviced. 1B8 indicates that all other devices can interrupt the 
A/D converter. The third and final entry in the DCT is the address of the interrupt 
servicing program, AINTS. AINTS is found on page 4 of the driver listing, and 
will be discussed later. 

Lines 25 - 29 contain additional variables and constants which are required while 
servicing requests to this handler. These values are, in order, the device code 
of the A/D converter, a busy/done status flag, pointers to the address and data 
tables, and the number of points to be read for this call. 

Page 2 of the driver listing illustrates two subroutines called by the user to attach 
(detach) the A/D converter interrupt servicing routine to (or from) the RDOS 
dispatch table, ITBL. The first routine, AIDEF, clears the ACTIV flag to indicate 
that there are no active requests in the handler for data. AIDEF then issues the 
system call .IDEF to define this handler and introduce it to RDOS. An error return 
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Analog to Digital Converter (Continued) 

could result if the AA^ converter device code (21 g) already was assigned to some 
other device. This would happen if a second call to AIDEF were issued without 
any intervening call to AlCLR. AICLR removes the A/TD routine from theRDOS 
dispatch table. 

Page 3 of the driver listing contains two subroutines, the analog read random routine 
(AIRDR) and the read request routine (AICHK). The first of these routines, AIRDR, 
is called with AC2 containing the address of a control table. This table is described 
on page I of the listing (lines 34 - 50). This subroutine first checks whether the 
device is currently active on another request by testing the ACTIV flag defined 
earlier (page 1, line 26). If the handler is already active, an error return is made 
to the user. If the handler is not active, the ACTIV flag is set and the request is 
initiated. The address of the control table is saved in the active switch and the num- 
ber of points to be read is moved into the handler from the table. Since this routine 
performs reads of analog inputs, two tables must be provided by the user. One 
table must contain the input point addresses to be read, and the other table (of equal 
or greater size) is used to store the analog input readings. The addresses of these 
two tables is given in the control table. Before returning control back to the caller, 
the address of the first point is fetched, sent to the converter, and the converter 
is started. 

The fourth routine, AICHK, is used to check the status of a call made to the 
converter. There are two returns to the caller: busy and call completed. 
Page 4 of the driver Listing contains the interrupt service routine, AINTS. This 
routine is entered from the RDOS interrupt dispatch program with AC2 containing 
the address of the A/D converter DCT and ACS containing the address of the 
RDOS interrupt dismissal program. AINTS reads the new converted value, saves 
it in the user-supplied data buffer, and then checks to see if there are additional 
points to be read. If there are, it initiates the next conversion. If this was the 
last point to be read, AINTS sets the status of the request to indicate that the call 
is completed and the handler is available for the next user request. 
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LICENSED MATEHIAL " PROPEKTY OF DATA GENERAL COWPORaTIDn 
0001 AIDEV MACRO REV 02 0i:iHl2b 12/00/73 

01 

02 I ANALOG TO DIGITAL CONVERTER DtVlCt DRIVER 

03 I , 

04 J ...................................... 

05 

,TITL AlOfcV 
07 

08 ,ENT A10EF,AICLRrAlKDH,AlCHK 

09 

10 .NREL 

11 

la I DEVICE CONTROL TABLE LAYOUT 
13 I -,.. 

14 

15 00000i00e001iAODCTI U5DCT I ADDRESS OF ADCV OCT 

16 

17 00001'000011'USDCTI AISAVE f INTERRUPT STATE SAVE AREA 

IB 000021000200 1B8 I MASK NQRO 

19 0000d'000063t AINTS | INTERRUPT ROUTINE ADDRESS 

20 

21 I ADDITIONAL VARIABLES FOR AOCV HANDLER 

22 I •^..w..^*....*.........,........ . 

23 

24 00004'h)00021 OCODEI ADCV 1 DEVICE CODE OF A/D CONVERTER 

25 00gjA5 I ngaaua krjru* 

26 00006 •14000(40 DAPTRI 

27 0B007»00000Pt OVPTRt 

28 00010*000000 OTCNTt 
29 

30 000U'000010 AISAVE: .BLK 10 
31 



t CTATIIC Cl Ar 



» DATA ADDRESS ARRAY POINTER 
f DATA VALUE ARRAY POINTER 
I DATA COUNT STORAGE 



32 
33 
34 
95 

36 
37 
38 

39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
90 



; STATE SAVE AREA 
USER CONTROL TABLE LAYOUT 
WORD 



WORD I 
MORD 2 
WORD 3 



STATUS FLAG 
■ CALL COMPLETED SUCCESSFULLY 
-VE ■ REQUEST BEING PROCESSED 

ADDRESS TABLE POINTER 

DATA STORAGE TABLE POINTER 

NUMBER OF POINTS TO BE READ 



0014000 .DUSR 

000001 ,OUSR 

000002 .OUSR 

000003 tOUSR 



STATiO 

ATPTR*! 

VTPTR"2 

NPT«3 
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10002 AIDEV 

01 

02 I INITlAUIZt THk A/U HANDLEK 



03 t — — - — -- — - . — -- — 

04 

05 > CALLING SEOUENCt: 

06 t JSR AIDLF 

07 I <ERROR WETUHN> I DEVICE. CODE In USt ALkEAQi^ 

08 I <NORMAL RETURN* 

10 00021 '054016 AIDEFJ STA 3 USP ; SAVE RETURN ADDRESS 

11 00022'1024a0 SUB ; SET RUUTINE NQT BUSY 

12 000231040762 STA ACTIV 

13 00024»0207b0 LDA DCODE i RfcT PEVirt CODE 

14 00025'024753 LOA I AUOCT I GET DCT ADDRESS 

15 00026»006017 .SYSTM I ATTACH TO RODS INTEKRuPT SYSTEM 

16 00027'021007 .IDEF 

17 00030'001400 JMP 3 f ERROR RETuRN 

18 00031'0014(fll JMP I 3 /NORMAL HETUKN 

19 

20 

21 I DETACH THE INTERRUPT SERVICING -^OUTiNfc 



22 I -,_—«- — - 

23 

24 I CALLING sequence: 

25 f JSR AICLR 

26 I <nORMAL RETURN> 
27 

28 

29 00032'054016 AICLR: STA 3 USP I SAVE RETURN ADDRESS 

30 00033*020751 LDA DCOUE 

31 00034f006017 .SYSTfi ? DETACH (-ROM RDOS INTERRUPR SYSTEM 

32 00035'021010 ,IRHV 

33 00036<ia01400 JHP 3 

34 00037'001400 JMP 3 ? NORMAL RETURN 



3-13 



01 

02 

03 

04 

05 

06 

07 

06 

09 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 



LICENSED 
AIDEV 



MATEHIAU - PROPEKTY OF DATA GEnEHAL COkPfjRATlON 



ANALOG READ RANUOM SUBROUTINE 



INPUT: 

AC2»CCNTRUL TABLE ADOKESS 

CALLING SEUtNCE! 
JSR AIRDR 

<ERROR RETU»N> I HANDLER ALREADY ACTIVE 
<NORMAL RETURN> 



000401020745 AIROR: LDA 

a0B41»l01004 MOV 

0004210014^0 JhP 

000431050742 STA 

000441021003 LDA 

00045*040743 STA 

00046(021001 LDA 

00047«040737 STA 

00050i021(!l02 LDA 

00051'040736 STA 

000521102000 ADC 

00053(041000 STA 

00054*022732 LDA 

00055*061121 OOAS 

00056*001401 JMP 



ACTIV 
SZR 
3 

ACTIV 
NPT 2 
DTCNT 
ATPTH 5 
DAPTR 
VTPTR S 
DVPTR 

STAT 2 
•DAPTR 
ADCV 
1 3 



I PICKUP STATUS FLAG 

I CHECK IT 

I ALREADY ACT1VE--ERR0R RETURN 

; SAVE CONTROL BLOCK ADDRESS 

I GET « POINTS TO 8E READ 

> SAVE AS DATA COUNT 

t GET STARTING ADDRESS OF POINT ApDRESSt 

; SAVE POINT ADDRESS TABLE 

; GET VALUE STORAGE TABLE ADDRESS 

f SAVE FOR STORING VALUES 

I SET REQUEST ACTIVE STATUS 

I GET FIRST PUINT ADDRESS 

» START UP CONVERSION 

; TAKE NORMAL RETURN 



ANALOG INPUT READ REQUEST CHECK SUBROUTINE 



INPUTS 

AC2«C0NTR0L TABLE ADDRESS 

CALLING sequence: 
JSR AICHK 
<BUSY RETURN* 
^COMPLETED RETURN> 



00057*021005" AICHKJ 
00060*101004 
00061 *001400 
00062*001401 



LDA STAT 2 
MOV SZR 
JMP 3 
JMP 1 3 



; GET CALL STATUS 

; REQUEST BEING PROCESSED 
> CALL COMPLETED 
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U004 

01 

02 

03 

04 

05 

06 

07 

08 

09 

10 

U 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 



L 
AID 



ICENSED 
EV 



MATERIAL - PROPERTY OF DATA GENfcRAL CQkPGRaTIDn 



00063' 
000e4> 
0006St 
000661 
00067* 
00070* 
00071* 
00072* 

00073* 
00074* 
00075' 
00076* 
00077* 



1 ANALOG TO DIGITAL CONVEHTtR INTERRUPT ROUTINE 
I .................. ... ... ........ 



062621 
042723 
014723 
000409 
102400 
042713 
040714 
001400 

010713 
010713 
022711 
061121 

00140^ 






AC2«0CT ADDRESS 

AC3*INTERKUPT DISMISSAL ROUTINE ADDRESS 



AINTSJ Dice feJ ADCV 



AIMOREJ 



STA 
DSZ 

JMP 

sua 

STA 
STA 
jMP 



#OVPTK 

DTCNT 

AIMORE 

id 

#ACTI¥ 

ACTIV 

3 



IS2 DAPTf? 
ISZ DVPTR 
LDA #OAPTR 
OOAS ADCV 
JMP 3 

.END 



I READ VALUt--CLEAR CONVERTER DUNE FL 

I SAVE NEWtY READ DATA VALtJt 

I DECREMENT DATA COUNTER 

; MORE TO COMt 

I REQUEST COMPLETE 

f SET USER DONE FLAG 

t SET CONVERTER NUN-9USY 

t DISMISS THE INTERRUPT 

I INCREMENT ADDRESS POINTER 

; " DATA TABLE HQINTER 

; SETUP NEXT CONVERSION 

; START IT 

; DISMISS THE INTERRUPT 





LICENSED 


MATERIAL 


- PROPERTY OF DAT* 


GENERAL COR 


0005 AIDEV 












ACTIV 


000005 




1/25 


2/12 


3/lb 


3/lb 4/lb 


ADDCT 


000000 




1/15 


2/14 






4ICHK 


000057 


EN 


1/08 


3/44 






AICUR 


000032 


EN 


1/08 


2/29 






AIDEF 


0id0021 


EN 


1/08 


2/10 






AIMQR 


000073 




4/13 


4/19 






AINTS 


000063 




1/19 


4/10 






AIROR 


000040 


' EN 


1/08 


3/15 






AISAV 


000011 




1/17 


1/310 






DAPTR 


000006 




1/26 


3/22 


3/27 


4/19 4/21 


DCODE 


000004 




1/24 


2/13 


2/3«^ 




DTCNT 


000010 




1/28 


3/20 


4/12 




DVPTR 


000007 




1/27 


3/24 


4/11 


4/20 


USDCT 


000001 




1/16 


1/17 







4/10 
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External Interrupt Recognition 

This driver program illustrates an interrupt servicing routiiie which readies a 
user task as a result of an external interrupt. This program illustrates a type 
4066 digital interface device driver. 

Plage 1 of the listing is almost identical in form to the first page of the A/D driver 
listing discussed earlier. The only difference is in the variables and storage 
required by the digital interface. Here, the user must supply the address of a 
communications core location. When a call is made to attach the interrupt routine, 
address to the RDOS dispatch table (page 2 of the listing), AGO must contain the 
communications core address. After attaching the interrupt to the RDOS dispatch 
vector table, the initialization routine arms the digital interface so that is can 
cause an interrupt. 

When the external interrupt occurs, control is dispatched to the digital interface 
servicing routine, starting on line 38 of page 2. After the service routine gains 
control, it reads a sixteen bit digital register provided by the interface. If the 

register's contents are non-zero, the contents are transmitted to a user task using 
the task call . DCMT; after this, the Interrupt is dismissed. If the register's 
contents is zero, the interrupt is simply dismissed. Upon dismissal of the 
interrupt, the system re -arms the digital interface interrupts. 

A practical example of the use of such a scheme would be the servicing of an 
operator's console. Such a console would generate an external interrupt indicating 
that the operator desires some form of action by the computer; the sixteen bit 
register contents (selected by the console operator) would indicate exactly the type 
of action desired. 
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LICENSED MATERIAL - PROPERTY OF DATA GEnEkal CORPQRATIOn 
0001 DIDEV MACRO REV 02 ^1U1:02 12/0b/73 

01 
02 

03 I DIGITAL INTER^ACE (TYPE 4k56b) DEVICE DRIVER 

04 I -,„-,-,- — — — 

05 f *•*......«............... ........ 

06 

,TITL DIDEV 
08 

05 tENT DIOEF,DICLR 

10 

U ,EXTN ,lXhT 

12 

13 .NREL 

14 

15 000042 .DUSR DI0P42 » DEVICE CODE DEFlNITIDlvJ 

16 

17 I DEVICE CONTROL TABLE LAYOUT 

U I -t 

19 

20 000001000001'DIOCTI USDCT 1 ADDRESS OF DID UCT 

21 

22 00001«000004IUSDCT» DISAVE I INTEWWUPT STATE SAVfc. ^,RtA 

23 000021000400 IB7 I INTERRUP MASK 

24 00003t000036> DINTS I INTERRUPT RQUTlNt ADDHKSS 
25 

26 I ADDITIONAL VARIABLES AND STORAGE USED BY HANDUEni 

27 I * 

28 

29 00004>000010 DISAVEI .BLK 10 I STATE SAVE AREA 

30 000141000042 DCODEI DID I DEVICE CODE 

31 00015*000000 DICOMt I COMMUNICATIONS ADDRESS 
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LICENSED MATERIAL - PROPERTY OF DATA GENEKAL CORPORATION 
1^002 DIDEV 
01 
02 I INITIALIZE THE DIUITAL INTERFACE 

03 ; —.—.-—--——-——— — — 

04 

05 I INPUTI AC^ariESSAGE ADDRESS 

06 

07 ; CALLING SEQUENCEI 

08 I JSR DIDtF 

09 I <ERROR RETURN* t DEVICE CODE (UlU) ALREADY IN USE 

10 I <NORMAL RETURN> 

11 

12 000161054016 OIDEFl STA 3 USP 

13 00al7»040776 STA OICOM ; SAVE COMHUNICATIOnS ADDRESS 

14 00020*020774 LDA DCOPE 

15 00021'024757 LDA 1 DIDCT 

16 00022'006017 .SYSTM t ATTACH TO ROOS INTERRUPT SYSTtM 

17 00^231021007 .IDEF 

18 00024»001400 JMP 3 ; ERROR RETURN 

19 00025»060142 NIOS DID I ARM THE EXTERNAL INTERRUPT 

20 00026»001401 JMP 1 3 I NORMAL RETURN 

21 

22 I DETACH THE INTERRUPT SERVICING ROUTINE & CLEArt OEvICE 

23 I - 

24 

25 t CALLING SEQUENCE: 

26 t JSR DICLR 

27 1 <NORMAL RETURN> 
28 

29 00027'054016 DICLR! STA 3 USP 

30 00030*060242 NIOC DID t CLEAR DID DEVICE 

31 00031 '020763 LDA OCODE 

32 00032*006017 ,SYSTH f DETACH HANDLER 

33 00033*021010 .IRMV 

34 00034*001400 JMP 3 I NORMAL RETURN 

35 000351001400 JMP 3 f " " 
36 

37 
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I T r B Hi K c r. 



ka A T CD T A I 



. Dur(t>t.UTV nf. n/iTa (,f-'NPkA! flOKHUk AT I OiN 



3b 

39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
90 
51 
52 
S3 
54 
55 
56 
57 
58 
59 



; DIGITAI iNTfeRi-ACE EXTtRNAL INTEkRUPT HANDlEH 

I -..-- ........... ................. 

I input: AC2«DCT ADPRtSS 

t AC3»1NUKRUPT DISMISSAL ADDRts^S 



000361^)64542 OINTS! DIAS 1 Did 
00837 '1258^9 MQV I 1 S^f 



00041 
001342 
00043 
00044 
00040 
00046 
00047 
00050 
00051 



•054412 

*050410 
1102400 
1042751 
'020750 
'177777 
'0004li!)l 
'0304,32 
'002402 



STA 3 
STA 2 

SUB 

STA 

UDA 

• IXMT 

JMP ,+1 

LDA 2 SAVt2 

JMP ^DISMISS 



D1SMI6S 

SAVt2 



PDICOM 

DICOM 



000521000000 SAVE2: 
000531000000 DISMISS: Id 



; READ 16 BIT REGISTEK 

; VALUE ZtRU ? 

f YtS--UISMlSS INTERRUPT 

I NO--SAVE DISMISSAL KQuTlNt ADijRcSS 

J SAVE AC2 ALSO 

J CLEAR SIGNAL ADURESS 

» GET SIGNAL ADURESS 

J INAKE UP USER TASK 

t RESTORE AC2 

> DISMISS THE INTERRUPT 

; TEMPORARY STORAGE KyR AC2 

I INTERRUPT DISMISSAL AuOREoS 



.END 



LICENSED 



0003 DIDEV 



U A T ITQ T II 



= PROPERTY OF DATA GENERAL COKPORATiaN 



DCODE 
DICLR 
DICOM 
OIDCT 
DIDEF 
DINTS 
DISAV 
DISMI 
SAVE2 
USDCT 
,IXMT 



000014 
000027 
000015 
000000 
000016 
000036 
000004 
000053 
000052 
000001 
000046 



EN 
EN 



XN 



1/30 
1/09 
1/31 
1/20 
1/09 
1/24 
1/22 
2/48 
2/49 
1/20 
l/ll 



2/14 
2/29 
2/13 
2/lb 
2/12 
2/44 
1/29 
2/56 
2/55 
1/22 
2/53 



2/31 
2/51 



2/52 



2/5irf 
2/58 
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Licensed Material - Property of Data General Corporation 

Multiprocessor Communications Adapter 

RDOS 03 extends system support to option 4038, the multiprocessor communications 
adapter (MCA). Nonetheless, the MCA can be treated as a user defined device. 
TTie following program illustrates such an MCA driver and illustrates die . STMAP 
call which is required when running data channel devices in the user area on a 
mapped system. 

Page 1 of the listing illustrates the MCA receiver and transmitter DCT's, RUSDCT 
and TUSDCT. These DCT's are standard user DCT's; note that bit zero is set to 
one. This is required when the devices are identified to the system in subroutine 
MfDEF, since they are data channel devices used in a mapped system. 

The MCA handler must be initialized before use, and this is done by a user call to 
MIDEF illustrated on page 5 of the listing. This routine identifies both the trans - 
mitter and receiver to the system and defines the number of 1024io word blocks 
which will be required for data channel transfers (two blocks each for transmissions 
and receptions). Additionally, this routine converts the logical buffer addresses, 
input to the initialization call, to physical addresses required for data channel 
transfers in m.apped machines (lines 34-43). That is, whenever a user program sets 
aside a series of logical locations as a data channel buffer, . STMAP returns the 
actual address assignments made by the mapping unit. All addresses in mapped 
user programs are logical, since the user program is unaware of the actual 
locations assigned by the hardware; the actual address assignements, however, 
must be sent to data channel devices. Beyond sending these addresses to the data 
channel devices, the user program need not be concerned with the actual address 
assignments. 

Since MIDEF identifies the MCA units to the system only once, MIDEF can be 
invoked by the user whenever different read/write buffers are to be used. 

The read and write subroutines proper are found on listing pages 2 and 3. Each of 
these routines first checks to see if the device is busy; if so, the error return is 
taken. Otherwise, each routine outputs the word count and logical starting address 
to its device, and the transmit routine also outputs the receiver number to the 
transmitter. Then each routine waits, via a call to .REC, until its associated 
interrupt processor (page 4 of the listing) readies it via an interrupt message call, 
. DCMT, indicating that the process is complete. The read/write routine then 
resets its busy flag and takes the call's normal return. 
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LICtNSEU MATEKlAL - PKOPERTY UF OaTa bfNEKAL COWPuRaTION 
\did\dl MCAUR MACkO RfcV \Ad li',i2'.?4 12/1H/73 

07 



; MULTIPRUCtSSOH CQfifUNICATIONS AUAPTtR fTYPE 4(^38) 



•TITLE MCAOk ; MCA DkIVEW 
,tNT dCARU mCaWT MIDEF 



t V mt . ucr 

A r\ • I I f • ■> u. w 



.NREL 

J DEVICE CONTKOL TABLE LAVnuT 
; . . 



09 
1^ 
1 1 

1 y 

U 

14 

lb 

lb 

1/ 

lb 

19 HWfei^li' lt?k;0iZ2'MKDCT: Ibfi + RUSDCT 

2k) i^feJi^idll ' laaMldS'MTDCT: 1B0 + TUSQCT 

21 

2i; i40w02'i/l0i£i0l2'RUSUCT: MSAvE 

2^ loididi05'00H0l0 ldl2 

24 I(5?!ti04'00icliai ' RiNTS 

2b 

2b 00t!!0b'/00012'TuSiJCT: MSAvE 

27 0(hw0b'itt0t^010 lfcJl2 

2b y0id07 '^^^Ik^e' TIMTS 

29 

«3li3 ; AUOITIONAL VARIABLES FUR MCA URlVtR 

31 ; 

32 

33 00Wl0'v50vi007 RCOUE: MCAR ? RECEIVEK UEVICE CUOE 

34 id0i(OU 'ia0000b TCOPE: HCAT ; TKAnShITTER OEVlCt CODE 
3b k)0k;12'tf0a0l0 MSAVE: ,BLK 10 ; STATE SAVE AREA 



f AQDkESS OF MCA RECEIVER OCT 
; AUDHESS Qf-' MCA TRANSMITTER I 

f Interrupt state save area 

; MASK wOkD 

; Interrupt routine address 

; interkupt state save area 

; mask word 

; interrupt ruutine audkess 
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LlCtNStO MATEKlAL - PKOPfcKTY OF 
M C A U R 

; MCA RtAU aUBRumiNF. 



DATA riFNtKAL COkPuPATIOn 



; Input :- 

; AC?i*wgRO COUNT 



; CALLING StouEiMCt:- 
; JSP MCAWD 
; <cRPOK Rt:rUKK> 
f <NOKMAL KtTUPN> 



HANQLtR ALRtAUY ACTIVE 







; output:- 






* 


AClaMCA STATUS 


tev>^2'd ' 


W«J042(a 


MCARD! 


LUA 2 RBUSY 


k)iiit:'2ci' 


15165^4 




MUV 2 2 SZR 


ifl 1^ k? 2 4 ' 


iiDi;) 113422 




JMP RtRTN 


k;iaK525' 


ici 1 1^ 4 1 5 




I5Z RbUSY 


fe)0w2& ' 


«n 5 ki 4 1 6 




STA 2 RSIliL + l 


idViid27 ' 


w5d412 




STA 3 RKTN 


\69^id'A\d ' 


^62\dv.J 




UOH MCAR 


t'f/'^ii 


1^24414 




LUA 1 RADDR 


i^\AV)i2 


<j6blKi7 




UOAS I HCAR 


\d^^i'i 


i<i2vi4l0 




LUA W RSlbL 


idV^V>i4 


17/777 




,HEC 


l^0k5<JD 


' 1024011 




SuB ^ 


0i<1W Jo 


' i/)4h44e)4 




STA RBUSY 


W iti <i 7 


'i£>la4e32 




ISZ RRTN 


\^<lM/)4\d 


' rt k: 4 ^3 I 




JhP J^HRTN 


(if.eiii)41 


' vl PI v^ ti fef 14 


wkTn: 





^ ('1 y^ 4 2 


' '/1 1^ k. \fiiOl 


RbUSYS 


1 


t!lirtk:i40 


' i/l0i^gl44 


'ksibL; 


.♦I 


Ii!l^ld44 


' wtfl|ti(a((ll 




,tjL^ 1 



*^ORD 



id((5e)4b '^Jldweik!0 radur: ^ 



It, / w 4 7 



' tl3l^4M2 
' (^ I?! I 4 H 



RtRTN: 



LDA 
JMP 



RUVHSY 
3 



PICKUP STATUS FLAG 

CrItCK TT 

DtVICfc ausY 

StT RUUllNfe BUST 

PtStT OONt SISGisAL 

SAVt RfeTURN AUDRFSS 

StNU wOKD CUUnT to RECEIVtR 

PICK UP LOGICAL STARTING AOURtSS 

StNU STARTING AUORESS 

WAIT FOk uPtRATlON COMPLETE FLAG 



; RESET RtCtlVtK BUSY FLAG 
J TAKfc NORMAL RcTURN 



00ii5b0 ' iii^i'.'^o7 RQVttSy: eksih 



; RECtlVFR tiUFFER LOGICAL AUDRESS 

t AS DEFINED BY .STMAP SYSTEM CALL 

; DURING DEVICE INITIALIZATION . 

; DEVICE ALREADY BUSY 

; PROCESSING A PRtVlOUS CALL 

f SlMULfANEDUS kEADS UR WRITES NOT ALLOW 
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fell 

04 
{!)& 

lb 
U 

12 
13 
U 
15 
lb 
1/ 
lb 
19 
7>i' 
2\ 
2-t 
23 
24 
2t) 
26 
27 
2e 
2S 
3i(i 

31 
32 
33 
34 
35 
36 
37 
3fa 
39 
4^1 
41 
42 
40 
44 
45 
46 
47 
4b 
49 



fci3 



LICtNSED 

MCAOR 



MATEkIAL - PkOFEkTY UF DATA GENEKAl C0KPU«AT10N 



1^0051 
01(^1(352 
t:il^w53 
li^ li9 5 4 
If' K itf 5 3 

fe)i;^id!>7 

ifl0ti62 
fe)Mi^63 
k? PI 1(564 
fc^i?w6b 
e)M^66 
0(i*'ei67 

i!^Hw71 
/ w 7 ii 

»i?/j73 
0k'!vl74 

t!3(dK373 

i^He'7b 



; MCA WHITE SUBKOUTlNt 



InPuT:- 

aci^sword count 

AClsRtCtlvEK NUMBtR IN rillS t^-3 (1-17(8]) 

CALLING StQuEr^Ct:- 
I JSR MGAwT 
; <tRknK HtlUKN> 

f <nurmal retukn> 
; output:- 

; AClsMCA STATUS wORD Fu« TKANSMlTTtR 



031(^423 MCAwT; 
Iftlfe1l04 

id 101^773 
t11k!)4^0 
K344423 

U54414 
((i6<i0v)6 
K)244i6 
06O0H6 
i<i3i?415 
i^731td6 
t3 2/>41id 
« 1' « 3 4 • 
I 2 4 K3 r^ 
^ 4 4 1'l 4 
1 1^ 4 2 
k3S5i:4i<3l 



LUA 
MUV 
JMP 
1S2 
STA 
STA 
STA 
UUB 
LUA 
DOA 
LUA 



2 

2 

TE 

Tb 

1 

2 

3 

1 
1 

2 



K!) W 1 



T K T N ; 
TbUSY: 



DUC5 2 
LUA i^ 
,REL 

sue R 

STA 
laZ TN 
JiiP fT 



1 



TbUSY 
2 SZR 
RTN 
USY 
RtCDV 
TSlbL+1 
TkTn 
MCAT 
TADUR 
MCAT 
RfcCDV 
MCAT 
TSICjL 



TeiUSY 
Tn 
RTN 



; PICKUP bTATuS FLAb 

; Check it 

; ALRtAUY ACTIVE - tRROR RETURN 

; iNlUCATt UEVICE IS BUSY 

; SAVE KfCfclVER NuMbEk 

; RESET TRAMSMltTER DUNE Slb^AL 

; SAVt kEUjkM ADDRESS 

; PICKUP LOt»ICAL STARTING ADDRESS 



; WAIT FOR uPcRATlON COMPLETE 

; RESET TRANSMITTER BUSY FLAG 
; TAKE NORMAL RtTuRiX TO USER 



i^j!^0t176'TSIbL: . + i 



1(1*^4577 'id(3i<)H/)« TADDR: 



k)00046'T£RTN5 RfcRTN 



i^&ili1i« 'i^VltiM*?;!^ RECDV; 0i<3 



; TRANSMITTER BUFFER LOGICAL AODRESS 
; AS UEFINEU BY .STMAP SYSTEM CALL 
; DURING DEVICE INITIALIZATION . 

TRANSMITTER BUSY ERROR' kEIURN 



; RECEIVER UEVICE NijMttEK 
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01 
H2 

(/)b 

n 
12 

u 

10 

lb 

IS 

ly 

21 

22 



i<34 



LlCcNSEJ 
MCtUR 



MATERIAL - Pr<OPtKTY JF DATA UtNEhAL C.OKPuRATION 



', ^iCA RtCtlVEK iNTf-KKuPT HRUCtSbOK 



toPlHl 'KiftObia? PINTS? IJICC 1 i-lCAK 



l!:)0102 'i(i2w74l 
^)010»S' \77777 
k£'< ii^ 1 4 ' e! bi 4 1(1 d 
^M10D '(d(^kl4a5 



LUA H RSIbL 

.IXMT 

JMP D1SM16S 

JMP DISMISS 



MCA TKANSMlTTtK lNTtP><UPT PKOCESSUR 



; CLEAR RtCtlVEK/KEAO STATUS 
; t'tT SIGNAL ADiJRtSS 



0^11^0 'tobbbi^e TINTS: 
\/jf6lV\7 'il2w7b6 
k5 i! 1 1 w ♦ '4 « if • 1 3 ' 
fc ?5 1 1 1 ' 1^ fe'i ir.' 4 1 
i^ii^U2't)3K)4i<i2 DISMISS! 
(^l?l ICS Ub<f2/<2 



Dice 1 MCAT 
LDA Id TSIbL 
,IXMT 

JMP ,tl 

lDa iJ USCDt 
KiiOL MAP 



Mtii 14'.50e>C9i«?3 DSCOfc: 0.) 



; CLEAR TRANSMlTTtR/RtAD STATUS 
; GET SIGNAL ADL'RhSS 



; GET DISMISS CODE 

; THlbGER THE MMPU 

J CODE KOR DISMISSING THE INTERRUPT 

; UNDER A NUVA 84ld SYSTEM 
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100(95 
Ml 

02 
96 
{d4 
at 

do 

0/ 

0h 

09 

11 

12 
li 
XA 
lb 
lb 

17 

lb 

ly 

2U 
21 

2^ 
2o 

24 

25 
2t) 
27 

2b 

2» 
•31^ 
31 
32 
3o 
34 
35 
3b 
37 
3b 
3& 
Ak) 
41 
42 
43 
44 
4b 
4b 
A7 

4b 

49 

5M 
51 
52 
53 



LiCtNSE 
MCAuR 



MATEkIAL - PROPF.RTY OP DATA GENERAL LflKPURATION 



l<5feU 
001 
(201 
001 
001 
001 
001 

001 

001 
001 
001 
001 
001 
001 
001 
00 1 
00 1 

001 

001 
001 
001 
001 
001 
001 
00 1 
001 
001 
k301 
001 
001 
W0i 



15 
lb 
17 

20 
21 
22 
23 
24 
25 
2b 
27 
30 
31 
32 
33 
34 
35 
36 
37 
40 
41 
42 
4^ 
44 
4D 
4b 
47 
50 
51 
52 
53 



'054437 

'04irt724 
'044755 
'010445 
'000414 

'02(66(36 

'024655 
'030432 

'006017 
'021007 
'002425 
'020661 
'024650 
'006017 
'021007 
'002420 
'054420 
'020652 
'0247ki3 
'00D017 

'021035 
'002412 
'044702 
'0206 45 
'024727 
'00t)0l7 
'021005 
'002404 
'044726 
'0l04ki2 
' 002401 



iNlTlALlZt THE MCA HANDLER 



^^iPUT:- 

AC0aSTAKTlN(, CORE AuDRESS 
AClsSTARTINli CORE ADDRESS 



Or RECEIVES? BUFFER 
OF TRANSMITTER bUFFER 



; CALLING SEQUENCE:- 

; JSR MIDEF 

; <tRROR RETURN> 

; <normal returim> 



MIDtF: 



mactv: 



001 

001 



55' 177 777 

56';^!00002 



HCArv: 
C2: 



STA 3 MXRTN 
STA RBUSY 
STA I TBOSY 
ISZ MCATV 
JMP MACTV 
LUA RCOUE 
IDA 1 MROCT 
LDA 2 C2 
.SYSTM 
.lOtF 

JMP *MIKTN 
LDA TCOUE 
LUA 1 MTUCT 
.SYSTM 
.IDtF 

JMP ^MIKTN 
STA 3 MCATV 
LUA RCODE 
LDA 1 RbUSY 
.SYSTM 
.STMAP 
JMP iMiRTN 
STA 1 RADUR 
LUA TCOUE 
LuA I TttUSY 
•SYSTM 
.STMAP 
JmP «»MIRT^ 
STA I TADuR 
ISZ MIKTN 
JMP PMIKTN 



00154 i00y!i000 mirtn: 



-1 
2 

.END 



; SAVE WETURN ADDRESS 

? SAVE USER BUFFER ADDRESSES 

DEVICE ALREADY INTRODUCED TO SYSTEM? 

YES, JUST GET LOGICAL ADDRESSES 

RECEIVER DEVICE CUDE 

RECEIVER DEVICE CONTROL TABLE 
; NUMBER OF JK BLOCKS 
; DEFINE DEVICE TO SYSTEM 



; Take errpk return 

J TRANSMITTER DEVICE CODE 

; TNANSMITTER DEVICE CONTROL 

; DEFINE DEVICE TO SYSTEM 



TABLE 



? TAKE ERROR RETURN 

? StT ACTIVE FLAG 

! GET DEVICE CODE 

; USER BUFFER ADDRESS 

; GET LOGICAL ADDRESS OF BUFFER 



TAKE ERROR RETURN 
SAVE LOGICAL ADDRESS 
DEVICE CODE 
GET BUFFER ADDRtSS 
GET LOGICAL ADDRESS OF 



USER BUFFER 



; TAKE ERROW RETURN 

; SAVE LOGICAL AODRtSS OF TRANSMITTER f 

; NURMAL RETURN 

; RETURN ADDRESS 



; MCA DEVICE ACTIVE FLAG 

; NUMbER OF lk)24 WORD BLOCKis FOk MCA 
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LictMseu 


MATEKIAL 


- PROPERTY Of- OAT; 


k IJENf 


(9k906 


MCAOk 












C2 


0«i 1^156' 




b/22 


5/51 






DlShl 


ViiA\fil U ' 




4/08 


4/(^vi 


4/ly 




OSCUE 


nweiiu' 




4/l« 


4/21 






MACTV 


iiw0l3b' 




5/19 


5/3i 






MLAKD 


k)lt)0^2<f * 


EN 


1/114 


2/16 






MCATV 


MideiiSb' 




5/18 


5/31 


5/5w 




MCAWT 


aw^iidsi ' 


En 


1/lW 


3/17 






MiOtF 


enatJiib' 


EN 


1/lM 


5/15 






MIRTN 


iA\d^X5A^ 




ft/15 
5/47 


5/25 


5/3^5 


5/36 


MHDCT 


yidHidiflW 




1/19 


5/21 






M5AVF- 


M 1^ t.n 2 ' 




1/22 


1/2p 


1/35 




MTDCT 


(AidP)t4tai ) 




l/2id 


5/27 






RADDR 


0ld(3>d45 1 




2/2«i 


2/38 


5/37 




RbUSY 


0felf^t!142' 




2/lb 


2/19 


2/28 


2/33 


RCOOF. 


061?.k)lk5' 




1/33 


5/20 


5/32 




RUVbS 


M»i5(a5K}' 




2/42 


2/45 






HtCUV 


00010W' 




3/21 


3/2/ 


3/49 




RtRTN 


Ok90lt}46 




2/ie 


2/42 


3/40 




RINTS 


«H01B1 




1/24 


4/PI5 






RRTN 


I9i^(1v441 




2/21 


2/29 


2/3ki 


2/32 


RSIbL 


iAatfi^A^ 




2/2k5 


2/25 


2/35 


4/H6 


RUSPC 


^\iidvn;i2 




1/19 


1/22 






TAOUR 


id^aviid?? 




3/25 


3/42 


5/43 




TbUbY 


k>id0'^74 




3/17 


3/2^ 


3/32 


3/37 


TLOUE 


fcii^M^l I 




1/34 


5/26 


5/3a 




T t R T N 


w1 V? 1(1 4 




3/19 


3/46 






TINTS 


I^WKlt^O 




1/28 


4/14 






TRTN 


HHi;)iii7o 




3/23 


3/33 


3/34 


3/36 


TSIbL 


«ldfci»S75 




3/22 


3/29 
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